Session Definitions

Use the MAI : Session panel to define and modify session definitions. A session definition specifies the application associated with the session and other control information. To define a session, you specify the following information:

Only a user that has an A privilege class can maintain session definitions and store the definitions for reuse.

Use the MAI : Session panel to specify session details and session operation parameters.

The session panel is presented under the following circumstances:

Each of the displayed MAI : Session Panel fields are described as follows:

Session Id

Specifies an identifier for the session. Commands and messages use this identifier. Make this identifier as meaningful as possible.

Default: $APPLn where n is an identifying number

Limits: One through eight characters

Logon Request

Specifies a string that identifies the application to which you want to log on and any additional information to pass to the application as a logon request.

Range: 50 characters

Jump Keys

Use the fields in this section to define the jump keys for use by this session. Valid values for each of the following fields are ATTN, PA1 through PA3, and F1 through F24.

Forward Keys

Used as forward jump keys.

Reverse Keys

Used as reverse jump keys.

MAI Menu Keys

Used to display the MAI : Primary Menu.

Swap Keys

Used to jump to the other window when operating in split-screen mode.

Screen Print Key

Used to print the current screen image by jumping to the Print Screen option of the Screen Image Services (SIS) Menu.

SIS Menu Key

Used to display the Screen Image Services (SIS) Menu.

Session Characteristics

Use the fields in this section to define session control characteristics.

Wait if inactive?

Specifies whether MAI waits if the target application is unavailable. MAI will, by default, abandon an attempt to start a session if the application associated with it is unavailable.

If you specify Y in this field, MAI waits indefinitely for the application to start.

Note: Specifying Y is only applicable if the application with which the session is established is prepared to acquire sessions or recover sessions after they have failed.

While MAI is waiting for connection to the session, the status displayed on the MAI : Primary Menu is WAITING. You can cancel a waiting session by using the C (Cancel) command against the session definition in the session list on the MAI : Primary Menu.

Default: N

Restart at end?

Specifies whether MAI attempts to recover a session that has ended (rather than abandoning it). If you specify Y in this field, MAI maintains the session environment when the session ends and attempts to reconnect the session to the application.

Default: N

Fast Jump?

Specifies whether MAI suppresses the read-buffer operation when jumping from the session if no I/O operations have been performed on the session since it was last selected. If you are operating from a remote terminal (that is, a terminal attached to a telecommunications line), specifying Y in this field can provide a significant improvement in performance. Unless you are using a remote terminal, you specify N in this field.

Default: N

Compress?

Specifies whether MAI performs compression (optimization) of data streams transmitted to the terminal, regardless of the actual data stream generated by the target application. Enter Y to specify compression.

Default: Y

Logmode

Specifies the name of a logmode table entry. When a session is started, MAI sets a particular set of session bind parameters automatically. Use this field when you want to nominate a set of bind parameters other than the defaults chosen by MAI.

Node Name

Specifies a network resource name that is referred to as a node name.

If you want the target application to regard the session request as originating from a terminal with a particular name, you can specify that name in this field. However, you site must have defined this name previously.

Script Name/Parms

Specifies the name of an NCL procedure that is executed as the script for this session. This script can be executed at session start, explicitly through the .S session command, and under certain forced termination conditions. You can specify any parameters required by the script after the script name.