SPI Programming Considerations
NonStop Pathway/iTS Management Programming Manual—426749-002
3-26
Resetting Values in Fields
•
FNAME32COLLAPSE, similar to the system procedure FNAMECOLLAPSE,
converts 32-byte file names to external format.
•
FNAME32EXPAND, like the system procedure FNAMEEXPAND, converts file
names in external format to 32-byte internal format.
•
FNAME32TOFNAME converts a file name from 32-byte format to Guardian
internal format, if possible.
•
FNAMETOFNAME32 converts a file name from Guardian internal format to
32-byte format, if possible.
Resetting Values in Fields
Certain constants can be used with an ALTER command to reset any optional field in
an extensible structured token to its default value. A reset constant causes the
PATHMON process to return an error if the field represents a required parameter and
to reset the attribute to its default value if the field represents an optional parameter.
The Pathway subsystem reset constants are listed in Table 3-6.
Resetting Fields With the TACL Program
To reset fields of type FNAME32, CRTPID, or SUBVOL with the TACL program, you
must use the #SETBYTES built-in function. More information on resetting fields with
the #SETBYTES built-in function is available in the SPI Programming Manual.
Table 3-6. Reset Constants
This Constant… Resets…
ZPWY-VAL-RESETALPHABYTE An alphanumeric byte
ZPWY-VAL-RESETALPHAINT An alphanumeric word
ZPWY-VAL-RESETBOOLEANBYTE A Boolean byte
ZPWY-VAL-RESETBOOLEANINT A Boolean word
ZPWY-VAL-RESETNUMERICBYTE A numeric byte
ZPWY-VAL-RESETNUMERICINT A numeric word
ZPWY-VAL-RESETNUMERICINT2 A numeric doubleword
ZPWY-VAL-RESETNUMERICINT4 A numeric quadrupleword
ZPWY-VAL-RESETFNAME32 A 32-byte field
ZPWY-VAL-RESETCRTPID A field containing a process ID
ZPWY-VAL-RESETOBJECTNAME A field containing an object name
ZPWY-VAL-RESETSUBVOL A field containing a subvolume name