SPI Programming Considerations
NonStop Pathway/iTS Management Programming Manual—426749-002
3-25
32-Byte File Names
32-Byte File Names
Some commands require that you send a file name to the PATHMON process through
the SPI interface. A 32-byte field is required to represent file names for DSM, rather
than the 24-byte field that is typically used for this purpose.
Whenever you assign a file name to a field, you must supply the file name as follows:
•
Bytes 0 through 7 contain the name of the system that hosts the file. The name
must include the leading backslash character (\) and be left-justified with filler
tokens (ZPWY-DDL-FILLER).
If the system is not part of a network and is not named, bytes 0 through 7 contain
the backslash character (\) followed by seven blank characters.
•
Bytes 8 through 31 contain the file name in local internal form.
Example 3-1 gives examples of acceptable formats for file names:
The following procedures are provided in the system library for handling file names in
this format:
10. Reissues the INFO TERM command
with the special selector and adds the
context token from the previous
response to the message.
11. Returns an empty response buffer
(the context token is absent) and the
error value ZPWY-ERR-PM-
NODATA.
12. Interprets that there are no more
TERM objects about which to obtain
information.
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 "
The Application… The PATHMON Process…