TS/MP Management Programming Manual (G06.24+, H06.03+)

SPI Programming Considerations
NonStop TS/MP Management Programming Manual—540082-001
3-21
Resetting Values in Fields
These procedures are provided in the system library for handling file names in this
format:
•
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-4.
Example 3-1. Format for 32-Byte File Names
File Name 32-Byte Format
Byte
# 0....5....10...15...20...25....31
\A.$B "\A $B "
\A.$B.#C "\A $B #C "
\A.$B.#C.D "\A $B #C D "
\W.$X.Y.Z "\W $X Y Z "
Table 3-4. 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