Previous Topic: PLOT CommandNext Topic: SESSLIST Command


SESSCONFIG Command

The SESSCONFIG command populates a REXX stem variable with configured session attributes for sessions selected according to specified criteria from a given session definition set. This command has the following format:

"SESSCONFIG [SESSTYPE({sesstype|ENABLED|DISABLED|ALL})] [DEFSET(sessiondefinitionset|STARTED|SAVED)] [PREFIX(sessconfig)]" 
SESSTYPE

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

sesstype

Lists attributes of all sessions in the selected 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
ENABLED

Lists attributes of all sessions configured as enabled.

DISABLED

Lists attributes of all sessions configured as disabled.

ALL

Lists attributes of all sessions in the selected session definition set.

Default: ALL

DEFSET

(Optional) Specifies the which definition set from which to get information

sessiondefinitionset

Specifies the name of the session definition set from which to get information

STARTED

Uses the session definition set that is currently loaded in AP Desktop, which is unaffected by any configuration or runtime changes made after AP Desktop starts

SAVED

Uses the session definition set that is currently selected as active in Configuration Manager

Default: STARTED

PREFIX

(Optional) Specifies the REXX stem variable that stores the session attributes. This value can be a maximum of 15 charaters.

Default: SESSCONFIG

Output of the command follows:

prefix.DEFINITION_SET

Contains the session definition set name

prefix.0

Contains the total number of returned sessions

prefix.i

Contains session name, 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 configured as automated.
  • NO: Session is configured as non-automated.
CONNECTED

Indicates the connection status:

  • YES: Session is configured to connect on startup.
  • NO: Session is configured not to connect on startup.
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
ENABLED

Indicates if a session is to be loaded:

  • YES: Session will be loaded on CA Automation Point startup
  • NO: Session will not be loaded
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 the 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".