INGSESS displays OMEGAMON® session definitions, the session
status and statistical information about the session.
Syntax
Parameters
session_name
The name of the OMEGAMON session
that an action is requested for. This parameter is only useful in
line mode.
More than one name can be specified for the REQ=DISPLAY
function. Wildcards are supported. The session name is mandatory for
the Start, Stop, and Detail request.
REQ=action
The action that you want to perform for session_name.
It can be one of the following:
DISPLAY
Returns the list of sessions that match the specified filter criteria.
This is the default.
DETAIL
Returns details for the named session.
START
Creates a new session using the session attributes for session_name.
Figure 1 is displayed when you enter the
INGSESS command at the NetView command
line. Figure 1. INGSESS Command
Dialog Panel
INGKYSS0 SA z/OS - Command Dialogs Line 1 of 8
Domain ID = IPSFM -------- INGSESS --------- Date = 04/22/05
Operator ID = NETOP1 System = KEYA Time = 14:18:55
CMD: B Start session C Stop session D Details
CMD Session System Type Status Appl-id User id SessOper
--- ----------- -------- -------- ---------- -------- -------- --------
CICSKY41 KEYA OMIICICS ACTIVE IPSPOC0 SAOM AOFSES01
DB2SGG4 KEYA OMIIDB2 ACTIVE IPSPD2C SAOM AOFSES02
DB2SG14 KEYA OMIIDB2 SESSFAIL IPSPD2C SAOM AOFSES01
IMS742CR KEYA OMIIIMS ACTIVE IPSPOI0 SAOM AOFSES02
IMS743CR KEYA OMIIIMS MAINT IPSPOI0 SAOM AOFSES01
JHSY4MVS KEYA OMIIMVS ACTIVE IPSPM2RC SAOM AOFSES02
JHSY4MV2 KEYA OMIIMVS INACTIVE IPSPM2RC SAOM AOFSES01
OMSY4MVS KEYA OMIIMVS ACTIVE IPSPM2RC SAOM AOFSES01
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF12=Retrieve
The Cmd field allows you to display specific information
for each system. The following command code is available:
B
Creates a new session with the appropriate OMEGAMON, if it does not already exist,
that is, the session status is INACTIVE or MAINT. After successful
session creation, the session status is ACTIVE. The session remains
active until it is stopped, either explicitly (using command code
C), or implicitly by NetView on
behalf of OMEGAMON or session
task termination.
C
Destroys the session with the appropriate OMEGAMON. The session status will be changed
to MAINT. The session is disabled so as to prevent it from being created
implicitly again.
D
Displays details for the selected session, such as the session
attributes from the session definition, the current status, and statistical
information.
The Session column shows the name of the session that represents
an OMEGAMON monitor.
The System column shows the system that established the
connection to OMEGAMON.
The Type column shows the type of session, that is, the
OS or middleware that the OMEGAMON monitor
is monitoring.
The Status column shows the status of the session. It can
be ACTIVE, INACTIVE, MAINT, SESSFAIL, or AUTHFAIL.
The Appl-id column shows the name of the OMEGAMON VTAM® application
as defined by the installation during customization of the OMEGAMON product.
The User id column shows the user that is defined to log
on to the OMEGAMON application.
The user ID is needed to control access to the OMEGAMON application. It may be blank if
product level security is not implemented for this OMEGAMON application.
The SessOper column shows the automated function name that
was assigned to the session by SA z/OS® during initialization.
If command code D is selected, the detail screen as shown
in Figure 2 is displayed. Figure 2. INGSESS Command Dialog
Detail Panel
INGKYSS1 SA z/OS - Command Dialogs Line 1 of 22
Domain ID = IPXNG ---------- INGSESS ---------- Date = 04/22/05
Operator ID = NETOP1 System = KEYA Time = 14:43:23
Session : OMSY4MVS
System : KEYA in Sysplex : KEYAPLEX
Type : OMIIMVS
Description : OMEGAMON for MVS on KEY4
Status : ACTIVE
Session Operator : AOFSES01
Logical Unit : TFNG#000
Application id : IPSPM2RC
User id : SAOM
Password : SAFPW
Timeout : 29
Logon data :
Users...
NETOP1
Statistics...
Total # Commands : 13
Total # exception analysis : 14
Total # exceptions tripped : 630
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF12=Retrieve
The Session field shows the name of the session that represents
an OMEGAMON monitor
The System field shows the system that established the
connection to OMEGAMON.
The Description field shows descriptive information for
this session as specified in the automation policy.
The Status field shows the status of the session. It can
be ACTIVE, INACTIVE, MAINT, SESSFAIL, or AUTHFAIL.
The Session Operator field shows the automated function
name that was assigned to the session by SA z/OS during initialization.
The Logical Unit field shows the name of the source LU
that was assigned by NetView upon
establishing a Terminal Access Facility (TAF) fullscreen session.
The Application id field shows the name of the OMEGAMON VTAM application as defined by the installation
during customization of the OMEGAMON product.
The User id field shows the user that is defined to log
on to the OMEGAMON application.
The user ID is needed to control access to the OMEGAMON application. It may be blank if
product level security is not implemented for this OMEGAMON application.
The Password field shows the password in the form of a
string of asterisks or 'SAFPW'. This is the password used to logon
to the OMEGAMON application.
The Timeout field shows the maximum time to wait for a
response from OMEGAMON before
the request is terminated.
The Logon data field shows the data that is sent to the OMEGAMON session during logon.
The Users field shows a list of operators or *AUTO that
have interacted with the session since it became ACTIVE.
The Statistics section shows:
The Total # Commands field shows the number of commands
that have been issued on this session since the session became ACTIVE.
The counter is reset each time the session becomes ACTIVE.
The Total # exception analysis field shows the number of
exception trap analysis commands that have been issued since the session
became ACTIVE. The counter is reset each time the session becomes
ACTIVE.
The Total # exceptions tripped field shows the number of
exceptions that actually tripped as reported by the session since
it became ACTIVE. The counter is reset each time the session becomes
ACTIVE.
