LOGCHAR macroinstruction

Each LOGCHAR (logon-characters) macroinstruction defines a single logon message and the name of an application program, a logon-interpret routine, or a USERVAR. You can include more than one LOGCHAR macroinstruction in an interpret table.

VTAM® compares the logon message (character by character) with successive entries in the specified interpret table. If the leading characters in the logon message correspond to all the characters in an entry in the interpret table, VTAM accepts the logon message as valid (even though the logon message can be longer than the corresponding entry in the interpret table). If the first character or characters of several logon messages are identical, you should arrange the LOGCHAR macroinstructions so the logon sequences for the logon messages are from the most restrictive (greatest number of characters) to the least restrictive (fewest number of characters). For example:

SEQ1 LOGCHAR APPLID=(APPLICID,AP2),SEQNCE='LOG2'
SEQ2 LOGCHAR APPLID=(APPLICID,AP1),SEQNCE='LOG'

Otherwise, in the preceding example, if sequence LOG had preceded LOG2 in the interpret table, both logon messages LOG and LOG2 would be valid logons to application program AP1. If you use two or more LOGCHAR macroinstructions, they must be arranged so that their SEQNCE fields are in reverse collating order.

Note: Although you can define a USERVAR in the interpret table, you can use the interpret table entry in conjunction with a USS table to process an incoming character-coded LOGON. For details, see z/OS Communications Server: SNA Network Implementation Guide.