{
{   The purpose of this procedure is to restore the item_info for a catalog or
{ permanent file.  The item_info was originally obtained  from  the  permanent
{ file get info interfaces, and is viewed as a black box to the permanent file
{ utilities.  The item info contains information  about  the  permits  on  the
{ catalog  or  file.   If the item is a catalog, restoring this item_info does
{ NOT restore subfiles, or cause them to be registered in the catalog.  If the
{ item is a permanent file though, restoring this WILL causes all cycles to be
{ registered in the permanent file catalog, although the data for  the  cycles
{ is  not  restored  yet.   This  procedure assumes that the given catalog has
{ already  been  found  on   the   backup_file   (for   example,   using   the
{ pup$find_restore_entry  interface) and the backup file is assumed positioned
{ immediately after the  item_descriptor  for  the  item.   The  item_info  is
{ assumed  to  be next.  If the restore is successful the multi_item_info (for
{ catalogs) and hierarchy_list are skipped.  The caller of this  interface  is
{ assumed to have constructed the new name to be used online.
{
{       PUP$RESTORE_ITEM_INFO (NEW_ONLINE_CAT_HEAD, CATALOG, BACKUP_FILE,
{         FILE_POSITION, STATUS)
{
{ NEW_ONLINE_CAT_HEAD: (input) This parameter specifies the name that is to be
{       used as the name in restoring the item.
{
{ CATALOG:  (input)  This  parameter  specifies  whether  the  item is to be a
{       catalog or permanent file.  This interface can not used for cycles.
{
{ BACKUP_FILE:   (input,   output)   This   parameter   specifies   the   file
{       identification of the backup file.
{
{ FILE_POSITION:  (output)  This  parameter  returns  the file position of the
{       backup file after the request is complete.
{
{ STATUS: (output) This parameter returns the request status.
{
{       CONDITIONS:
{
{       IDENTIFIER: puc$pf_utility_id
{
