&MAISCMD

Specifies an MAI session command against the current session.

&MAISCMD session-command

The current session is set by the &MAISGET verb. The values are processed in the order of the in-storage MAI selection list when the MAI procedure terminates.

Operands:

session-command

Valid session commands are:

S

The command starts the session, if not already started, and selects it for display if no other has been previously selected.

A

Activates the session if not already active.

Note: It is not selected for display.

B

Positions the session as the last in the selection list of sessions.

T

Positions the session as the first in the selection list of sessions.

C, CU,

Cancels the active session. The session failure is reported to the associated CC, CF application as either an unconditional, conditional or forced disconnection.

H

Marks the session (if active) as hidden. It will not be selected via nonspecific session jumping.

SL

Marks the session (if active) as hidden until output arrives. Upon arrival of any data stream from the associated application, the hidden status is reset and the session is then eligible for selection by nonspecific session jumping.

M

Modifies the session definition. The session is active or inactive. If the session is active certain attributes cannot be changed: for example, node-name, script procedure.

U

Updates the session definition on external storage. A full-screen function is invoked to display the current stored definition. Changes made are not reflected in the current in-storage definition. The session definition is deleted by this function.

P

Purges the definition from the in-storage session definition list. The session is no longer displayed by the MAI menu. (However, unless it is also deleted via a stored definition update, it appears when MAI is re-initialized.)

L

Logs on to an inactive session displaying the session characteristics (for modification or confirmation) before starting the session.

R

Repeats a session definition. The current session definition is used as a model to build a new session definition that is placed in the session list immediately after the one selected. The session ID of the new session definition is set to blanks.