Previous Topic: SESSCONFIG CommandNext Topic: WTO Command

ADDRESS AXC Commands › Commands for Utilities › SESSLIST Command

SESSLIST Command

The SESSLIST command populates a REXX stem variable with current session attributes for currently loaded sessions selected according to specified criteria. Disabled sessions as specified in the active session definition set are not returned. This command has the following format: 

"SESSLIST [SESSTYPE({sesstype|AUTOMATED|PAUSED|CONNECTED|DISCONNECTED|ALL})] [PREFIX(sessname)]"
SESSTYPE

(Optional) Specifies the type of session to be listed. This operand can have one of the following arguments:

sesstype

Lists attributes of sessions in the active session definition set with the console type of sesstype. Possible sesstype names are:

  • ASYNCH
  • DTX
  • ISERIES
  • JES3
  • JES3MCS
  • MCS
  • RCS
  • SYSPLEX
  • TANDEM
  • TANDEMALL
  • VAX
  • VAXALL
  • VM
  • VSE
  • Default
AUTOMATED

Lists attributes of all sessions currently being automated.

PAUSED

Lists attributes of all sessions for which automation is paused.

CONNECTED

Lists attributes of all sessions currently connected to a host.

DISCONNECTED

Lists attributes of all sessions currently not connected to a host.

ALL

Lists attributes of all enabled sessions in the active session definition set.

Default: CONNECTED

PREFIX

(Optional) Specifies the REXX stem variable in which to store the session attributes.This value can be a maximum of 15 characters.

Default: SESSNAME

Output of the command follows:

prefix.DEFINITION_SET

Contains the session definition set name which is currently active in AP desktop

prefix.GLOBAL_PAUSE

Indicates whether global automation pause is currently in effect

prefix.0

Contains the total number of returned sessions

prefix.i

Contains session names (where i is 1 to prefix.0).

prefix.i.attribute

Reports following attributes for each session, where i is 1 to prefix.0 and attribute is one of the following keywords:

AUTOMATED

Indicates the automation status:

  • YES: session is currently being automated
  • PAUSED: automation is temporarily paused
  • NO: session is non-automated
CONNECTED

Indicates the connection status:

  • YES: session is currently connected
  • NO: session is currently not connected
CONSOLE_TYPE

Indicates the console type (Default, ASYNCH, MCS, TANDEMALL, DTX, RCS, VAX, JES3, SYSPLEX, VAXALL, JES3MCS, TANDEM, VM, VSE, ISERIES)

DEVICE_NAME

Indicates the LU name or Device name (applicable only for TN3270, TN5250 )

DEVICE_TYPE

Indicates the communication device or protocol used to connect the session

  • COMn: Serial communication port n (COM1, COM2, ...)
  • MEMORY: Session that uses memory as communication device
  • ETC: Session is controlled by the Event Traffic Controller
  • VIO: Windows command prompt session
  • TELNET, SSH, TN3270, TN5250: Session is connected to a remote host using this protocol
HOST_NAME

Indicates the host name (applicable only for TELNET, SSH, TN3270, or TN5250)

HOST_PORT

Indicates the port (applicable only for TELNET, SSH, TN3270, or TN5250)

MENU

Indicates a custom menu name or Default

SESSION_NAME

Indicates the name of the session

SYSTEM_NAME

Indicates the system name

TERMINAL

Indicates the terminal type (3278, 3278_2, 3278_3, 3278_4, 3278_5, 3279, 3279_2, 3279_3, 3279_4, 3279_5, 3477, 5292, 6530, ASYNCH, AXC, VIO, VIO43, VIO50, VT52, VT100, VT320, VT420)

TITLE

Indicates the title

If an attribute is not applicable for particular session, the attribute value contains the string "N/A".