TS/MP 2.5 Management Programming Manual

Example 1 Format for 32-Byte File Names
32-Byte FormatFile Name
Byte
3125....20...15...10...5....# 0....
"$B"\A\A.$B
"#C$B"\A\A.$B.#C
"D#C$B"\A\A.$B.#C.D
"ZY$X"\W\W.$X.Y.Z
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 8 (page 43).
Table 8 Reset Constants
Resets…This Constant…
An alphanumeric byteZPWY-VAL-RESETALPHABYTE
An alphanumeric wordZPWY-VAL-RESETALPHAINT
A Boolean byteZPWY-VAL-RESETBOOLEANBYTE
A Boolean wordZPWY-VAL-RESETBOOLEANINT
A numeric byteZPWY-VAL-RESETNUMERICBYTE
A numeric wordZPWY-VAL-RESETNUMERICINT
A numeric doublewordZPWY-VAL-RESETNUMERICINT2
A numeric quadruplewordZPWY-VAL-RESETNUMERICINT4
A 32-byte fieldZPWY-VAL-RESETFNAME32
A field containing a process IDZPWY-VAL-RESETCRTPID
A field containing an object nameZPWY-VAL-RESETOBJECTNAME
A field containing a subvolume nameZPWY-VAL-RESETSUBVOL
Building and Sending a Command Message 43