INITSELF


INITSELF(resource[,[mode][,[user_data][,log_byte]]])

Where

resource is a string expression. If resource is a string constant expression, it must be 1 to 8 alphanumeric characters and must not contain blanks. The characters must be enclosed in single or double quotation marks. String constant expressions containing hexadecimal strings are exempt from this restriction. The STL Translator will translate all lowercase characters to uppercase in these constants.

mode is a string expression. If mode is a string constant expression, it must be 1 to 8 alphanumeric characters and must not contain blanks. The STL Translator will translate all lowercase characters to uppercase in these constants. These constants must be enclosed in single or double quotation marks. String constant expressions containing hexadecimal strings are exempt from this restriction.

user_data is a string expression. The length of user_data should not exceed 255 characters although the STL Translator permits longer strings. A maximum of 255 characters will be sent.

log_byte is a 1-byte string constant or a string expression that specifies a byte of user data to be associated with all data transmitted and received. The log_byte remains active until data is "typed" and transmitted with a TRANSMIT statement or until an INITSELF, TERMSELF, or SNACMND statement is issued. This byte gives users of the Response Time Utility a way to identify transactions when gathering statistics by the various user-defined "log_byte" categories. Only the first character or first two hexadecimal digits of the string expression are used. The default log_byte is X'00'.

Function

The INITSELF statement sends an INITIATE SELF format 0 RU to initiate sessions when simulating SNA terminals or logical units (LUs).

resource specifies the name of the partner LU. The mode is the name of a mode entry table, which you may need to use when simulating SNA terminals or logical units. The user_data is typically information such as a password, which is unique to a user.

For additional examples of the INITSELF statement and a complete description of its use, see Logging on and off an application.

Examples

initself('MYAPPL','MYMODE','MYPASSWD')    /* Includes mode entry */
                                          /* and user data.      */

initself('MYAPPL',,'MYPASSWD')            /* Includes user data, */
                                          /* but no mode entry.  */

initself('MYAPPL','MYMODE',,'A5'x)        /* Includes mode entry */
                                          /* and log byte.       */
log_byte = 'm'
initself('MYAPPL',,,log_byte)             /* Includes a variable */
                                          /* log byte            */

Notes

The INITSELF statement causes a Transmit Interrupt. Thus, all accumulated message data will be sent.
The INITSELF statement is identical to specifying a type of INITSELF on the SNACMND statement.