general.header.q.ptr Definition/General


Command general.header.q.ptr Definition/General
Applicable release versions: AP 6.2
Category General (155)
Description accessing header information using normal Pick utilities.
Through the 6.2 OSFI, it is possible to access information about an item such as update stamps, permissions, ownership, and driver-specific data. The header driver translates this information into a format which looks like a standard Pick item.

Note that access to the header information via this driver is read-only. The only way to modify the header information is through the normal update routines. This is enabled via the "Y" correlative for Pick files. Header information updates on non-Pick items depend on the behavior of the remote file system to which those items belong.

Any utility which physically moves the data (like "copy") changes the header information.

The "save" and restore utilities save and restore the header information as well.

Raw Attribute Definitions :

When reading items via the header driver, the items are returned as a dynamic array with the following raw attribute definitions:

# Description

1 User ID - The Pick user name or the Unix user number in hex of the last user to update this item.

2 Pib - The Pick PIB (in hexadecimal) of the last user to update this item. This field is undefined for non-Pick drivers.

3 Time/date - A hexadecimal representation of the number of seconds elapsed since 12:00 AM December 31, 1967 and the time the item was last updated.

4 Permissions - A hexadecimal number representing the permissions on the item. This currently only applies to non-Pick items.

5 GroupID - This is the Group ID (in hexadecimal). This is currently used only by the Unix driver, but may be used by other drivers in the future.

Other attributes are driver-specific.

Q-Pointer Format :

The format of the header Q-pointer is:
001 Q
003 hdr:filename

'hdr' is the name of the 'hdr' host in the 'dm,hosts,' file.

'filename' is the name of the target file to examine. This may be a local Pick file (assuming the Y correlative has been added to the D-pointer), or a remote file (Unix or Dos).

The file may also be opened by pre-pending the filename with the string "hdr:".
Related general.super.q.ptr