TS/MP 2.5 Management Programming Manual

6 ZPWY-TKN- Definitions
This section discusses variable-length byte string tokens used in the token-oriented Management
Programming interface to TS/MP. Each variable-length byte string token has a value consisting of
a string of bytes of varying length. Table 23 (page 71) lists the variable-length byte strings provided
by the Pathway subsystem:
Table 23 TS/MP Variable-Length Byte Strings
ZPWY-TKN-DEF-SCPROGRAMOSSZPWY-TKN-DEF-SCARGLIST
ZPWY-TKN-DEF-SCSTDERRZPWY-TKN-DEF-SCCWD
ZPWY-TKN-DEF-SCSTDINZPWY-TKN-DEF-SCDEFINE
ZPWY-TKN-DEF-SCSTDOUTZPWY-TKN-DEF-SCENV
The information in this section is general information. Information about a definition specific to a
particular command or response appears in the description of that command or response, later in
this manual.
Definitions in this section appear in Data Definition Language (DDL) format. Definitions of structures
use DDL definition statements. For an explanation of DDL, see the Data Definition Language (DDL)
Reference Manual.
Definitions encountered in TS/MP that are used uniquely by Pathway/iTS to support TCPs and
terminals and objects related to them are described in the Pathway/iTS Management Programming
Manual.
Definitions whose names begin with ZPWY- are Pathway subsystem definitions. These definitions
are provided in the DDL file ZSPIDEF.ZPWYDDL, and in the corresponding files for other languages.
ZPWY-TKN-DEF-SCARGLIST
This token specifies an Open System Services (OSS) startup argument list, which is a list of strings
separated by commas that is made available to OSS server processes in the argv[ ] array.
token-type ZSPI-TYP-BYTESTRINGdef ZPWY-TKN-DEF-SCARGLIST
The first two bytes of the string is the length, of the argument list that follows. The third byte is the
start of the argument list. Each argument string in the list must be terminated by a null character.
A null string is valid. Each null, whether a null string or a null used to terminate an argument, is
one byte in length. For example, five arguments are represented here, each terminated with a null
(represented in this example by #); the third and fifth arguments are null strings, and the total length
of the argument list is 17 bytes:
arg1#arg2##arg4##
The length of the argument list can be from 2 to 24,000 bytes. The combined total length of
ZPWY-TKN-DEF-SCENV and ZPWY-TKN-DEF-SCARGLIST must not exceed 24,000 bytes.
The program name that is automatically passed as the first argument (argv[0]) does not need to
be specified by the user, nor is it included in the 24,000 character maximum.
If you do not assign a value for this token when adding a server class, then the default is an empty
argument list.
To reset the value for this token in an ALTER command, specify a string length of 0 in the first two
bytes of the string. If the token is not included in the command buffer, the current value is not
changed.
This token is returned in the response buffer of an INFO command only if a value is defined.
This field is valid for OSS server processes only.
ZPWY-TKN-DEF-SCARGLIST 71