ViewPoint Manual

Customizing ViewPoint
ViewPoint Manual—426801-001
6-31
Commands for and Responses From the
Status Server
Descriptions of the pertinent fields follow. Fields not mentioned exist for compatibility
reasons; your server should not use or alter those fields.
Z-PW-REPLY-CODE of ZVPT-IPC-HDR
is the Pathway response code. It must be set to 0 (indicating no errors) or 3
(indicating that an error occurred). The error code (if any) is set in Z-IPC-RETN-
CODE.
Z-VERSION-CODE of ZVPT-IPC-HDR
on entry, is the software release version of the command message structure; on exit,
it is the release version of the response message structure. The server should set the
version code to the version of GDDL that it is using, even if an error is being
returned.
Z-IPC-RETN-CODE of ZVPT-IPC-HDR
is set to 0 (zero) or to an error code to be returned. Figure 6-9 lists the allowed
error-code values.
Z-REQUEST-CODE
is present in all commands, immediately following the message header. It contains a
code indicating the type of command made. Figure 6-9 lists the possible values of
this command code.
Figure 6-9 gives the DDL for the command-code values that ViewPoint sends to the
server and the error-code values that the server can return.
Figure 6-8. Status-Server Message Header
definition ZVPT-IPC-HDR.
02 Z-REQUEST-CODE type binary 16.
02 Z-PW-REPLY-CODE redefines Z-REQUEST-CODE
type binary 16.
88 Z-RQST-OK value is 0.
88 Z-RQST-ERR value is 3.
02 filler pic x.
02 Z-VERSION-CODE.
03 Z-LETTER pic a.
03 Z-REV-NUMBER pic 99.
02 Z-IPC-RETN-CODE type binary 16
value 0.
02 Z-IPC-RETN-CODE-DETAIL type binary 16
value 0.
02 Z-LOG-THIS-IPC pic a.
02 filler pic x.
end.
definition Z-REQUEST-CODE type binary 16.