LIST (NCCF)
Syntax
Purpose of Command
The NCCF LIST command gives information about your NetView® session, including the current primary and backup focal points.
Operand Descriptions
- ASSIGN
- Lists message assignments or operators assigned to groups.
- AUTH
- Lists unsolicited and authorized message assignments.
- COPY
- Lists solicited message assignments.
- GROUP
- Lists the operators assigned to all groups defined by the ASSIGN command.
- OP=operid|ALL
- Specifies the operator ID of an operator for which an assignment
was made. ALL is the default.
You can use this keyword only with ASSIGN=AUTH, ASSIGN=COPY, and ASSIGN=GROUP. This keyword causes LIST ASSIGN to list only the assignments that contain the indicated operator ID. Groups are not resolved in listing message assignments (LIST ASSIGN=AUTH or LIST ASSIGN=COPY). If the operator specified on the OP operand is assigned to a group and that group is assigned to a msgid, that msgid is not included in a list of message assignments. For example, if you enter
LIST ASSIGN=AUTH,OP=OPER1
, you receive a list of the authorized message assignments that contain OPER1.You can designate sets of operators by specifying a prefix followed by a #. The assignments for all the operids that begin with the characters preceding the # are displayed. For example, if you enter
LIST ASSIGN=COPY,OP=OPER#
, you receive a list of the COPY assignments for all messages assigned to operators whose operids begin with OPER. - MSGID=message_id|ALL
- Specifies the message identifier for which an assignment was made.
ALL is the default.
You can use this keyword only with ASSIGN=AUTH or ASSIGN=COPY. This keyword causes LIST ASSIGN to list only the assignment for the indicated message_id. If you specify a prefix followed by an asterisk (*), you receive a list of the assignments for the specified character string. The asterisk is not a wildcard because of its use with the ASSIGN command. For example, if you enter
LIST ASSIGN=COPY,MSGID=IST*
, you receive a list of the copy assignment for IST*, but not for all messages beginning with IST.You can designate sets of messages by specifying a prefix followed by a #. The assignments for all the message_ids that begin with the characters preceding the # are displayed. For example, if you enter
LIST ASSIGN=AUTH,MSGID=IST#
, you receive a list of the authorized message assignments for all message_ids that begin with IST. - GROUP=groupid|ALL
- Specifies the group identifier for which an assignment was made.
ALL is the default. See the ASSIGN command for more information.
You can use this keyword only with ASSIGN=GROUP. This keyword causes LIST ASSIGN=GROUP to list only the group assignment for the specified group.
You can designate sets of groups by specifying a prefix followed by a #. The assignments for all the groupids that begin with the characters preceding the # are displayed.
- CLIST=clist_name
- Is the name (member name or synonym name) of the command list you want displayed. If this CLIST is loaded in storage by LOADCL, the in-storage CLIST is displayed. If not, the NetView program reads the CLIST from the DSICLD library. A header line indicates whether the CLIST was found in storage or on disk. If you want to read the CLIST from DSICLD, use BROWSE.
- CONNSEC
- Displays information related to the TCP/IP stacks from which connection security information is
being collected. For each stack, LIST CONNSEC displays a data line that provides details about the
stack, which is followed by the KEEP filtering lines that are associated with the stack in the
CNMSTYLE member. The format of the data line is as
follows:
The variables in the data line are as follows:CONNSEC TCPNAME: tname TASKID: tname STATUS: ACTIVE|INACTIVE
- CONNSEC TCPNAME: tname
- The TCP/IP name of the stack.
- TASKID: tname
- The name of the autotask responsible for collecting connection data for the stack as defined by the TCPCONN DEFINE command or the FUNCTION.AUTOTASK.CONNSEC CNMSTYLE statement.
- STATUS: ACTIVE|INACTIVE
- The status of the connection. The possible values are as follows:
- ACTIVE
- Data collection is currently running.
- INACTIVE
- Data collection is not currently running, and no TCP/IP connection data is available for queries.
- CZFILTER
- Displays a report of the names of CANZLOG filters that are available for reference in the BROWSE command. You can also create additional named filters using the CANZLOG command.
- DEFAULTS
- Lists the NetView system defaults and the number of memory dumps taken for storage overlay or control block overwrite conditions (DMPTAKEN).
- DSILOG
- Displays the status of the network log.
- DST=dstname
- Displays the outstanding data services task (DST) requests. The
identifier of the operator who made the request, the DST request number,
the step sequence number, and an indicator for the last DST request
are displayed. Note: For DSIUDST, the level of security is also displayed.
- OP=*|ALL|PPT|operid
- Lists operators having DST or timer requests. Valid parameters
are:
- *
- Lists DST or timer requests for your own operator ID. If you do not specify OP, this is the default.
- ALL
- Lists all operators having the DST or timer request specified.
- operid
- Lists only requests for the named operator and DST or timer request. You can specify operid even if the operator is not currently logged on.
- PPT
- Lists the primary program operator interface task (PPT) timer requests.
- FOCPT
- Displays the status focal points. The FOCALPT QUERY command provides support for all focal point categories including user-defined categories. The FOCALPT QUERY command also displays the backup focal point names.
- hclname
- Is the name of the hardcopy log device whose status you want displayed.
- IPADDR
- Displays a list of the spans that include the specified IP address from the NetView span table. If the IP address is not defined to any spans, a value of NONE is displayed in place of the list of spans. In this case, the IP address can still be valid and access authority exists if the operator has CTL=GENERAL or CTL=GLOBAL authority. The value of IPADDR cannot contain wildcard characters. An asterisk (*) or question mark (?) character is used literally. An IP address is also a resource except that this IP address changes to a standard format before span checking is performed (if necessary). The IPADDR value can be an IPv4 or an IPv6 address. See the IBM Z® NetView Security Reference for a description of the IP address standard format.
- KEY=
- Lists PF and PA key definitions.
- ALL
- Lists all the PF and PA key definitions. A message is given for keys that have not yet been set.
- PAkey
- Gives you the individual PA key settings. The key can be from 1 to 3.
- PFkey
- Gives you the individual PF key settings. The key can
be from 1 to 24. Note: The response to a LIST KEY command is a multiline message. The message ID of the first message in this multiline message is DSI606I.
- APPL
- Specifies the application for which you want PF or PA key settings
listed.
- ALL
- Lists PF/PA key settings for all applications.
- applid
- Lists PF/PA key settings for a specific application. The name
must be 1-8 alphanumeric characters, and can contain @, # and $. The
following NetView applications
provide default PF and PA key settings:
- log browse (LBROWSE)
- member browse (MBROWSE)
- NCCF
- NLDM
- NPDA
- STATMON
- WINDOW
- DISPFK
If applid is omitted, the default is the current application, or if the current application is neither one of the previous key settings nor an applid specified by DSIPSS, the default is NCCF.
Note: Because keys are arranged in a hierarchy (specific applid, VIEW and NETVIEW), it is useful to know which key definitions exist at the different levels. For this reason, the application for which a given key was set (SET-APPL) and the setting for that key are displayed. VIEW default keys are listed for applid VIEW, application IDs for which the VIEW keyword was specified in the last SET, and for VIEW applications which have been started.
- MEMSTAT=*|ddname|membername
- Displays information about members such as whether it is loaded
in storage, storage size of the member, number of times accessed or
"hits", date and time member was loaded, and what task loaded the
member.
- *
- Lists all members indicated by the OP operand.
- ddname
- Lists all members in the specified DDNAME. See the BROWSE command for a list of valid DDNAMEs.
- membername
- If the value specified is not a DDNAME, the member is listed.
- OP=*|ALL|PPT|operid|NONE|%
- All members matching the MEMSTAT value are displayed if you do
not specify this keyword.
- *
- Lists all members which match the MEMSTAT value. This is the default.
- ALL
- Lists all the loaded members.
- PPT
- Lists the members loaded by the PPT.
- operid
- Lists the members loaded by the named operator.
- NONE
- Lists the members not loaded.
- %
- Lists the members not loaded or loaded by the operator processing the LIST command (used by CLIST CNME1054).
- MSG
- Lists message assignments.
- AUTH
- Lists unsolicited and authorized message assignments.
- COPY
- Lists solicited message assignments.
- operator_id
- Displays current information for the specified operator. This
information includes:
- The terminal name the operator is using
- The name of the hardcopy log being used
- The profile name being used
- The session status
- Whether the operator is eligible to be the authorized message receiver
- Whether the operator has specific, general, or global control
- Whether the operator has NMC administrator authority
- The default MVS™ console name
- The view security level being used for the operator
- The domain list
- The active span list
- *
- An asterisk (*) in place of the operator_name indicates
that you want your status to be displayed. You can also receive this
information by specifying two single quotation marks (''). The information
includes:
- Terminal name
- Name of the hardcopy log
- Profile name
- Session status
- Authorized message receiver
- Span of control (specific, general, or global)
- NetView management console administrator authority
- Default MVS console name
- View security level assigned
- Domain list
- Active span list
When the terminal is the NetView 3270 management console, the TCP/IP address of the console is also shown.
Your active span list contains the access level at which you started the span. If OPERSEC=SAFDEF is in effect, the PROFILE field on the display has a value of N/A. If OPERSEC=SAFDEF was in effect when you logged on but is not currently in effect, the profile field on the display has a value of NONE.
- OPKT
- Lists each TCP/IP stack name and associated autotask name depending
upon the following definitions:
- The names specified with the PKTS DEFINE PSOURCE=OSA command. See the NetView online help for more information about the PKTS command.the PKTS command in the IBM Z NetView Command Reference Volume 2 (O-Z) for more information.
- The value defined with the FUNCTION.AUTOTASK.OPKT statement in the CNMSTYLE member. See the IBM Z NetView Administration Reference for more information.
- OVERRIDE=opid
- Lists the NetView system defaults, along with any defaults that have been changed for the specified operator using the OVERRIDE command. If you do not specify opid, the defaults for the operator issuing the LIST command are displayed.
- PERSIST
- Displays the status of all enabled PIPE PERSIST elements.
- PKTS
- Lists each TCP/IP stack name and associated autotask name
defined by the PKTS DEFINE command or the FUNCTION.AUTOTASK.PKTS statement
in the CNMSTYLE member. The format of each data line is as follows:
PKTS TCPNAME: tname TASKID: tname STATUS: ACTIVE|INACTIVE|DORMANT GTF: NO
The variables in the data line are as follows:- PKTS TCPNAME: tname
- The name of the TCP/IP stack.
- TASKID: tname
- The name of the autotask responsible for collecting packet data for the stack, as defined by the PKTS DEFINE command or the FUNCTION.AUTOTASK.PKTS statement in the CNMSTYLE member.
- STATUS: ACTIVE|INACTIVE|DORMANT
- The status of the connection. The possible values are:
- ACTIVE
- The data collection is currently running.
- INACTIVE
- The data collection is not currently running, and no packet trace data is available for queries or purges.
- DORMANT
- The data collection is not currently running, but any previously collected data is still available for queries or purges. A connection can become dormant as a result of the PKTS STOPCOLL command or because of an error.
- GTF: NO
- The GTF tracing status of the connection. Currently, GTF tracing is not supported for packet data.
- PRIORITY
- Lists all NetView tasks and their priorities. The NetView priorities can be 0 - 9, where 0 is the highest priority. The tasks are listed in order of their priority, with the highest priority task listed first.
- RESOURCE=rname
- Displays a list of the spans that include the specified resource name from the NetView span table. If the resource name is not defined to any spans, NONE is displayed in place of the list of spans. In this case, the resource can still be valid, and access authority exists if the operator has CTL=GENERAL or CTL=GLOBAL authority. The value of rname cannot contain wildcard characters. An asterisk (*) or question mark (?) is used literally.
- REXXENV
- Displays the settings of the current REXX environment in which this LIST command is running. This parameter is valid only when the LIST command is issued from a REXX program or EXEC. The settings that are displayed are the same for any non data REXX environment that runs in the NetView address space.
- REXXPARM
- Displays the contents of the REXX parameters that are to be passed to the REXX interpreter when the NetView program initializes a REXX environment. This includes any settings from REXX.CMDENV and REXX.FUNCPKGLIST statements that are coded in the CNMSTYLE member; for more information about these CNMSTYLE statements, see the Administration Reference.
- ROLL
- Displays a list of components to which you can return to continue operation. Use either the ROLL or RESUME command to return to the active component.
- SAFOP
- Displays operator information stored in the requested segment
in RACF® or other SAF product.
The selected operator does not need to be logged on. The displayed
information does not contain passwords.
- *
- Lists the information for the issuing operator.
- opid
- The name of the SAF operator whose USER class segment information is to be listed.
- SEGMENT
- Displays segment information for any operator by any authorized NetView operator.
- BASE
- Displays the SAF user RACF/base segment information.
- LANGUAGE
- Displays the SAF user Language segment information.
- NETVIEW
- Displays the SAF user NetView segment information.
- OMVS
- Displays the SAF user OMVS segment information.
- SECOPTS
- Displays a list of the security options, their current values, the date and time of the last update, and either the last operator ID to update the option or INITIALIZATION if the option has not been dynamically changed using the NetView REFRESH or DEFAULTS commands.
- SPAN=span_name
- Displays the resources and views from the NetView span table. If a resource or view name contains an asterisk (X'5C'), question mark (X'6F'), blank (X'40'), comma (X'6B'), or quotation mark (X'7F'), it is preceded by the escape character (").
- STATUS
- Displays the status of the specified operand. Valid operands are:
- AMLUSESS
- Displays all VTAM-LU sessions.
- CANZLOG
- Displays the numbers of messages that are collected for each of the various tag values and the
message rate for the past minute. The following screen capture displays an example of what is
displayed when LIST STATUS=CANZLOG is specified:
* D01NV LIST STATUS=CANZLOG ' D01NV CNM600I Canzlog status: Active Total messages, this IPL: 3903 Average Message Rate, prior minute: 50 Buffering available for about 480 thousand messages Max storage: 512 megabytes Current storage: 128 megabytes Stress level: 0 Skip level: 5 Skip gap: 1 Data available from 08/19/18 06:20:32 at HLQ=XYZ01ABC For system ABDEF7 archiving running at subsystem ABCD
- CNMSESS
- Displays all active communication network management (CNM) data sessions with your NetView program and the status of these sessions.
- NNT
- Displays all the NNT (NetView-NetView task) sessions.
- OPS
- Displays all the operator terminals known in this domain.
- OPT
- Displays all the active optional tasks.
- SPANS
- Displays a list of all the spans defined in the NetView span table.
- TASKS
- Displays all the tasks, except virtual OSTs (VOSTs), in your NetView system.
- EXTEND=0|1
- When EXTEND=1 is specified, the following are added:
- MOD:
- This is followed by the name of the module that runs the task.
- VITAL:
- This is followed by YES or NO, indicating whether the task is reinstated by the NetView program automatically if it fails. See the NCCF STOP command for more information.
- RXENVCNT=NO|YES
- When RXENVCNT=YES is specified, each NetView subtask list entry
includes the count of REXX environments that is currently initialized
(active or inactive) for that subtask, including any Data REXX environments,
followed by its percentage of all NetView REXX environments in parentheses.
The number of inactive environments can be up to the REXXENV value
specified on the DEFAULTS/OVERRIDE commands. See DEFAULTS (NCCF) for information about
the DEFAULTS command; for more detail on the OVERRIDE command, see IBM Z NetView Command
Reference Volume 2 (O-Z). The
main task (MNT) is the first entry in the list and shows the total
number of REXX environments available to the NetView program followed by the total number
of REXX environments in use by the NetView program.
The percentage of REXX environments in use by the NetView program follows in parentheses.
Because virtual OSTs (VOSTs) are not included in this list, the number of REXX environments in use by any one VOST can be found by issuing a LIST STATUS=VOST command and then issuing a LIST vost_taskname command where vost_taskname is taken from the TASKNAME: value for the VOST entry of interest.
RXENVCNT=NO is the default and leaves out this item.
- WLM=NO|YES
- When WLM=YES is specified, each NetView subtask
list entry includes either of the two following entries, starting
in column 95:
orSvcCls: Not Available
where WLMserviceClassName is the WLM service class assigned to the listed NetView subtask.SvcCls: WLMserviceClassName
The
Not Available
string appears for inactive tasks or tasks that are not yet assigned a WLM service class. The 'Not Available' string also appears if the NetView program is not enabled for WLM services through the NetView WLM style statement.WLM=NO is the default. If this default is used, the columns are blank.
- TSOSERV
- Displays all active TSO servers.
- VOST
- Displays all virtual OSTs (VOSTs) in your NetView system.
- XCFGRPS
- Returns a list of z/OS® XCF
groups in which the NetView program
participates. The following keywords are valid:
- GROUP=group_name
- Restricts output to the given group and its members. The name
can be 1 - 8 characters in length.
If you specify DSIPLX*, the XCF group to which this NetView domain belongs is listed.
You can specify a wildcard character (*) for NetView DSIPLXxx groups (DSIPLX*). Specify DSIPLX* to list the NetView group regardless of the value of the XCF.GROUPNUM statement in the CNMSTYLE member, and if you are at the enterprise master, you can list all the NetView programs that forward data to the enterprise master.
- MEMBER
- Restricts output to the specified member. The name can be 1 - 16 characters in length. The MEMBER option can be specified only when the GROUP option is specified.
- TASK=taskname
- The name of the task whose status you want displayed. To determine
the name of an optional task, use the LIST STATUS=OPT command. For
operator tasks, use the LIST STATUS=OPS command.
For task DSIUDST, the level of security is displayed.
- TCPCONN
- Displays information related to the TCP/IP stacks being managed
by the NetView program.
For each stack, LIST TCPCONN displays a data line providing details
about the stack, followed by the KEEP and DASD filtering lines associated
with the stack in the CNMSTYLE member. The format of the data line
is as follows:
TCPCONN TCPNAME: tname TASKID: tname STATUS: ACTIVE|INACTIVE|DORMANT GTF: YES|NO
The variables in the data line are as follows:- TCPCONN TCPNAME: tname
- The TCP/IP name of the stack.
- TASKID: tname
- The name of the autotask responsible for collecting connection data for the stack, as defined by the TCPCONN DEFINE command or the FUNCTION.AUTOTASK.TCPCONN statement in the CNMSTYLE member.
- STATUS: ACTIVE|INACTIVE|DORMANT
- The status of the connection. The possible values are:
- ACTIVE
- Data collection is currently running.
- INACTIVE
- Data collection is not currently running, and no TCP/IP connection data is available for queries or purges.
- DORMANT
- Data collection is not currently running, but any previously collected data is still available for queries or purges. A connection can become dormant as a result of an error that causes data collection to stop.
- GTF: YES|NO
- The GTF tracing status of the connection.
- terminal_name
- Is the name of the terminal whose status you want displayed.
- TIMER
- Displays timer requests.
- ALL
- Displays all the pending timer requests, depending on the OP operand. If you do not specify the OP operand, all pending non-PPT timer elements that you entered are displayed.
- reqname
- Displays the status of the named timer request. The reqname is the optional name specified on the ID operand of the AT, AFTER, or EVERY command or generated by the system.
- TRACE
- Displays the options currently in effect for the TRACE command.
- VIEW=vname
- Displays a list of the spans that include the specified view name from the NetView span table. If the view name is not defined to span, NONE is displayed in place of the list of spans. In this case, the view might still be valid, and access authority exists if the operator has CTL=GENERAL or CTL=GLOBAL authority. The value of vname cannot contain wildcard characters. An asterisk (*) or question mark (?) is used literally.
Usage Notes
- When listing a dynamic resource, such as the message routing tables created by the ASSIGN command (AUTH, COPY, or GROUP), duplicate entries might exist. This condition can occur when considerable ASSIGN command activity or routing activity is taking place that prevents old entries from being deleted. The last duplicate entry is the most recent entry added. If you encounter this problem, rerun the LIST command.
- If you enter a LIST command using a task name that is being used
by another command, such as the SWITCH command, the message
No further status available
is displayed. To obtain status, reissue the LIST command after the other command completes. - For hardcopy log printing, if a status of DEVICE DORMANT is given, this means that the task exists, but the hardcopy terminal is not connected.
- Timer requests are displayed in the order in which they are to run. A CHRON timer can be deferred by calendar or other conditions. The LIST TIMER runs asynchronously and requires a CORRWAIT stage if used in a PIPE.
- If you are listing information about a domain list, an A indicates an active cross-domain session, and an I indicates that no cross-domain session currently exists, but that you can start one.
- VOST task names, which are names of the format DSI#nnnn, cannot be specified for taskname. The status of VOSTs can be obtained using LIST STATUS=VOST.
- You must use RACF Version 2 Release 1, or later releases, or an SAF product with equivalent capabilities to issue the SAFOP parameter. Ensure that the SAF product is running and the security classes used by the NetView program (such as the NETCMDS class) are active. For information about how to set up these types of security, see the IBM Z NetView Security Reference.
- For cleaner output, you can also use the LISTWLM command instead of the LIST STATUS=TASKS,WLM=YES command.
- You can always list the details of the RACF/base segment of your
own user profile. To list details of the RACF/base segment of the
profile of another user, one of the following conditions must be true:
- You are the owner of the user profile.
- You have the SPECIAL attribute.
- The profile of the user is within the scope of a group in which you have the group-SPECIAL attribute.
- You have the AUDITOR attribute.
- The profile of the user is within the scope of a group in which you have the group-AUDITOR attribute.
- You must have the SPECIAL or AUDITOR attribute
- You have at least READ authority for the field within the segment through field-level access checking
Return Codes
- Return Code
- Meaning
- 0
- The operation was successful.
- 2
- SAF segment data was not found or is not defined.
- 4
- One of the following occurred:
- Syntax error
- Unknown name specified
- Not authorized to issue command
- 8
- An internal error occurred.
Example: Displaying your SAF NETVIEW segment data
LIST SAFOP=*,SEGMENT=NETVIEW
* NTV8E LIST SAFOP=*,SEGMENT=NETVIEW
' NTV8E
BNH176I Display of OPER1 SAF NETVIEW segment data.
IC: LOGPROF1
CONSNAME:
CTL: GLOBAL
MSGRECVR: NO
OPCLASS: 2
DOMAINS: NTVE9 NTVE8 NTVE7 NTVE6 NTVE5 NTVE4 NTVE3 NTVE2 NTVE1 NTV9E
NTV6E NTV5E NTV4E NTV3E NTV2E NTV1E B01NV CNM99 CNM02 CNM01
NGMFADMN: NO
NGMFVSPN:
Example: Displaying SAF BASE segment data
LIST SAFOP=OPER4
C NTV6D LIST SAFOP=OPER4
' NTV6D
BNH177I Display of OPER4 SAF BASE segment data.
NAME:
OWNER: ROOT
Created: 01.061
DFLTGRP: OMVS
PW changed: 00.000
PW INTERVAL: 30
Attributes:
REVOKE:
RESUME:
Last Recorded Access: 06.241/12:13:30
CLAUTH:
DATA:
MODEL:
Access days: ANYDAY
Access time: ANYTIME
GROUP: OMVS
AUTH: USE
Connect OWNER: ROOT
Connect date: 01.061
Connects: 7
UACC: NONE
Last Connect: 06.241/12:13:30
Connect Attr:
REVOKE:
RESUME:
SECLEVEL:
CATEGORY:
SECLABEL:
Example: Displaying the PF key settings for all applications
To display the PF key setting for all applications, enter
LIST KEY=ALL APPL=ALL (or DISPFK ALL)
Example: Displaying the status of the network log
LIST DSILOG
LIST DSILOG
TYPE: OPT TASKID: DSILOG TASKNAME: DSILOG STATUS: ACTIVE
MEMBER: DSILOGBK
PRIMARY:DSILOGP STATUS:
ACTIVE SECONDARY:DSILOGS STATUS:INACTIVE
AUTOFLIP: YES RESUME: NO
LOADMOD: DSIZDST
Task Serial: 19 REXX Environments: 1 (1%)
Messages Pending: 0 Held: 0
WLM Service Class: NETVIEW
END OF STATUS DISPLAY
This example shows that the task
name is DSILOG and it is active. The primary data set (DSILOGP) is
active while the secondary data set (DSILOGS) is inactive.Example: Displaying a specified command list
LIST CLIST=WTORC
LIST CLIST=WTORC
COMMAND LIST WTORC DEFINITION FROM DISK:
WTORC CLIST
&CONTROL ERR
&AREAID = '?'
WTO 'AREAID = &AREAID'
&WRITE RC FROM WTO = &RETCODE
&EXIT
Example: Displaying the status of a specified operator
LIST OPER1
The response is similar to the following example:
* D12NV LIST OPER1
- D12NV STATION: OPER1 TERM: D12A702
- D12NV HCOPY: NOT ACTIVE PROFILE: N/A
- D12NV STATUS: ACTIVE IDLE MINUTES: 0
- D12NV ATTENDED: YES CURRENT COMMAND: LIST
- D12NV AUTHRCVR: NO CONTROL: GLOBAL
- D12NV NGMFADMN: NO DEFAULT MVS CONSOLE NAME: NONE
- D12NV NGMFVSPN: NNNN (NO SPAN CHECKING ON NMC VIEWS)
- D12NV NGMFCMDS: YES AUTOTASK: NO
- D12NV IP ADDRESS: N/A
- D12NV OP CLASS LIST: NONE
- D12NV DOMAIN LIST: A01NV (I) A02NV (I) A20NV (I) A55NV (I) A57NV (I)
- D12NV A99NV (I) C01NV (I) C02NV (I) C03NV (I) C04NV (I)
- D12NV B10NV (I) B28NV (I) B63NV (I) B99NV (I) D (I)
- D12NV D16 (I) D01NV (I) D12NV (I) D52NV (I)
- D12NV ACTIVE SPAN LIST: NONE
- D12NV Task Serial: 18079 REXX Environments: 3 (2%)
- D12NV Messages Pending: 0 Held: 2
- D12NV WLM Service Class: NETVIEW
- D12NV END OF STATUS DISPLAY
In this example, the follow
information was provided: - PROFILE: N/A
- Indicates that OPERSEC=SAFDEF was in effect at the time the listed operator logged on.
- IDLE MINUTES: 0
- For attended tasks, this is the time since the most recent operator
action. Any operator action resets this value to zero. Examples of
operator action include issuing a command or making a selection on
a full screen display. It does not include a command resulting from
a previous EVERY command or from message automation.
For unattended tasks, this is the time since the most recent command from any source. Commands from message automation and timers do reset the value.
The time is rounded down to the nearest minute.
- ATTENDED: YES
- Whether commands are received from and messages are routed to
some controling authority. The values are as follows:
- YES
- The task has a standard VTAM® 3270 terminal connection or that the task was started by a START DOMAIN request (NNT)
- YES CONS
- The task is operated from an MVS system console.
- YES WEB
- The task was started by a request from a web browser.
- YES NMC
- The task was started by an NMC client and DEFAULTS AUTOLGN=YES was in effect.
- YES DIST
- The task was started by a RMTCMD request from another NetView program.
- NO
- None of the previous autotasks. The task was a standard autotask.
- CURRENT COMMAND: list
- The verb of the command currently running on the task, if any. If a synonym was used to initiate the command, then that synonym is listed. The value is the command as started. Commands called directly by other commands do not change the value.
- AUTOTASK: NO
- A modifier for the ATTENDED value and shows whether the task is
considered automated. The values are as follows:
- NO
- The value of ATTENDED is YES or YES IP.
- YES disconnected
- The value of ATTENDED is YES NMC, YES DIST, or NO and the task is eligible for reconnect.
- YES
- None of the previous modifiers.
- IP ADDRESS: N/A
- The value is an IP address when the task was started by a request from a web browser. The value is the address of the web application server.
- Task Serial: 18079
- Every task started by the NetView program is assigned a serial number when attached. The serial number is an integer in the range of 1 - 4294967295. If a task is logged off, or stopped and then restarted, it is assigned a new serial number.
- REXX Environments: 3 (2%)
- This is the number of REXX environments (active or inactive) that are currently initialized for this task followed by its percentage of all NetView REXX environments in parentheses.
- Messages Pending: 0 Held: 2
- The first number is the number of messages (or commands) that have been sent to the task since it was last able to receive new messages. The count does not include messages that have been accepted by the task and are being processed. The second number shows how many messages are currently being held by the task because the messages are marked as action, or are subject to HOLD(Y) action by automation or the MSGROUTE command.
- WLM Service Class: NetView
- NetView is the WLM service class assigned to the listed subtask. This is replaced by 'Not Available' for inactive tasks or tasks that are not yet assigned a WLM service class.
Example: Displaying your status
LIST *
The response is similar to the following example:
* D12NV LIST *
- D12NV STATION: OPER1 TERM: D12A702
- D12NV HCOPY: NOT ACTIVE PROFILE: DSIPROFA
- D12NV STATUS: ACTIVE IDLE MINUTES: 0
- D12NV ATTENDED: YES CURRENT COMMAND: LIST
- D12NV AUTHRCVR: NO CONTROL: GLOBAL
- D12NV NGMFADMN: NO DEFAULT MVS CONSOLE NAME: NONE
- D12NV NGMFVSPN: NNNN (NO SPAN CHECKING ON NMC VIEWS)
- D12NV NGMFCMDS: YES AUTOTASK: NO
- D12NV IP ADDRESS: N/A
- D12NV OP CLASS LIST: NONE
- D12NV DOMAIN LIST: A01NV (I) A02NV (I) A20NV (I) A55NV (I) A57NV (I)
- D12NV A99NV (I) C01NV (I) C02NV (I) C03NV (I) C04NV (I)
- D12NV B10NV (I) B28NV (I) B63NV (I) B99NV (I) D (I)
- D12NV D16 (I) D01NV (I) D12NV (I) D52NV (I)
- D12NV ACTIVE SPAN LIST: NONE
- D12NV Task Serial: 18079 REXX Environments: 3 (2%)
- D12NV Messages Pending: 0 Held: 0
- D12NV WLM Service Class: Not Available
- D12NV END OF STATUS DISPLAY
Example: Displaying a specified timer request
LIST TIMER=RCF
DISPLAY OF OUTSTANDING TIMER REQUESTS
TYPE: EVERY TIME: 03/04/19 14:00:00 INTERVAL: 000 02:00:00 EVERYCON:YES
COMMAND: LIST SECOPTS
OP: OPER1 (OPER1 ) ID: RCF SAVED TIMEFMSG: YES LOCAL
1 TIMER ELEMENT(S) FOUND FOR OPER1
END OF DISPLAY
OP:
label is where the timed command runs (for
GROUP, as the first logged on operator in that group). The operator
name in parentheses indicates the origin of the timer command.Example: Displaying timer requests from an operator
LIST TIMER=ALL OP=OPER1
DISPLAY OF OUTSTANDING TIMER REQUESTS
0 TIMER ELEMENT(S) FOUND FOR OPER1
END OF DISPLAY
Example: Displaying Virtual OSTs (VOSTs)
LIST STATUS=VOST
TASKNAME: DSI#0603 OWNER: OPER2 ATTACHN: NLDM STATUS: ACTIVE
Example: Displaying the PF1 key setting in the hardware monitor
LIST KEY=PF1 APPL=NPDA
Example: Displaying PF10 Settings for all full-screen applications
LIST KEY=PF10 APPL=ALL
Example: Displaying the PF key settings for all applications
LIST KEY=ALL APPL=ALL
Example: Displaying the current security options
LIST SECOPTS
* NTVAA LIST SECOPTS
' NTVAA
BNH228I OPTION VALUE LAST UPDATED UPDATE ID
BNH229I ------- -------- ----------------- --------------
BNH229I OPERSEC NETVPW 04/04/19 10:45:50 INITIALIZATION
BNH229I OPSPAN NETV 04/04/19 10:45:51 INITIALIZATION
BNH229I CMDAUTH TABLE 04/04/19 10:45:51 INITIALIZATION
BNH229I TBLNAME CNMSCAT2 04/04/19 10:45:51 INITIALIZATION
BNH229I AUTHCHK SOURCEID 04/04/19 10:45:51 INITIALIZATION
BNH229I SPANAUTH NONE 04/04/19 10:45:47 INITIALIZATION
BNH229I SPANCHK SOURCEID 04/04/19 10:45:51 INITIALIZATION
BNH229I CATAUDIT NONE 04/04/19 10:45:47 INITIALIZATION
BNH229I AUTOSEC BYPASS 04/04/19 10:45:52 INITIALIZATION
BNH229I SURROGAT NO 04/04/19 10:45:51 INITIALIZATION
BNH229I RMTSEC NONE 04/04/19 10:45:53 INITIALIZATION
BNH229I RMTAUTH SENDER 04/04/19 10:45:51 INITIALIZATION
BNH229I WEBAUTH PASS 04/04/19 10:45:51 INITIALIZATION
BNH229I SARESAUT OFF 04/04/19 10:45:47 INITIALIZATION
BNH230I END OF LIST SECOPTS INFORMATION
The LAST UPDATED field shows when each security option was changed to its current setting. The UPDATE ID shows either INITIALIZATION or the operator ID that changed the setting after initialization.
- Operator passwords are checked through SAF.
- Span of control authorization is provided by a NetView span table. The table is named MAINSPAN.
- Commands and command list names are verified using a command authorization table DSICAUTH. Command authorization is checked against SOURCEID.
- By default, no audit records are written for the active command authorization table.
- Commands routed to operators from the automation table are verified.
- Cross domain RMTCMD and ENDTASK requests are verified using the DSISECUR table.
- Cross domain RMTCMD and ENDTASK requests use the operator ID of the sender, the domain, and network ID for authorization.
Example: Displaying span of control information
LIST SPAN=SPAN1
SPAN NAME: SPAN1
SPECIFIC RESOURCES: A01CDRSC, A01APPLS, A01CDRM, A01LOCAL, A01PATH,
A02CDRSC, A02APPLS, A02CDRM
GENERIC RESOURCES: A01NET* (OMIT: A01NETA.*, A01NETB.*), A01SWNET.*
SPECIFIC VIEWS: A01_Network, A02_RESOURCES
GENERIC VIEWS: NONE
Example: Displaying resource span of control information
LIST RESOURCE=A01CDRSC
A01CDRSC SPECIFICALLY DEFINED TO SPANS:
SPAN1, SPAN9, SPAN10
A01CDRSC GENERICALLY DEFINED TO SPANS:
SPAN7
Example: Displaying the current defaults
LIST DEFAULTS
For an explanation of the various defaults, see the DEFAULTS command. Some values, such as SENDMSG, SCRNFMT, and SCROLL, are not valid on the DEFAULTS command.
Example: Displaying members in storage
LIST MEMSTAT=*
The response is similar to the following example:
BNH375I
DDNAME MEMNAME HITS LOADTASK STORAGE DATE TIME DP
-------- -------- ------- -------- ------- -------- -------- --
CNMPNL1 MEMABC 105.96 DSIMEMST 28K 11/22/97 15:43:07
CNMPNL1 MEMXYZ 10.83
DSICLD CLIST21 1.12 OPER1 8K 11/23/97 12:24:18 *
DSICLD CLIST7 0.00 OPER1 4K 11/23/97 12:22:01
Example: Displaying active TSO servers
LIST STATUS=TSOSERV
The response is similar to the following example:
BNH376I
OPID TSOSERV MEMBER PPI NAME STATUS STARTER
-------- -------- -------- -------- --------- --------
NONE USER1 CNMSJTSO $8E00003 ACTIVE OPER2
OPER1 USER3 CNMSJTSO $8E00005 ACTIVE OPER2
OPER2 USER2 CNMSJTSO $8E00004 ACTIVE OPER2
Example: Displaying the status of all enabled PIPE PERSIST elements
LIST PERSIST
The response is similar to the following example:
DWO082I
Persist LRC Serial Action Mins Left
1STlist 794 R 20
PIPE 735 C 7
CASESIX 743 C 7
2NDlist 776 D 8
In this example,
the follow information was provided: - Persist
- Indicates the name of the PIPE enabling the PERSIST element.
- LRC Serial
- Long running command serial number.
- Action
- Indicates the action specified on the PERSIST stage specification:
- C - COMMAND
- D - DISPLAY
- R - ROUTE
- Mins Left
- Indicates the time that remains (in minutes) until the PERSIST element times out.
Example: Displaying interval timers
LIST TIMER=SYS*I
The response is similar to the following example:
* NTV74 LIST TIMER=SYS*I
' NTV74
DISPLAY OF OUTSTANDING TIMER REQUESTS
TYPE: TIME: 02/20/19 09:20:54
COMMAND: DSIPICRW *T* *
OP: OPER4 ( ) ID: interval TIMEFMSG: NO LOCAL
1 TIMER ELEMENT(S) FOUND FOR OPER4
END OF DISPLAY
Example: Listing XCF groups in the sysplex
LIST STATUS=XCFGRPS
The
response is similar to the following examples: - If there is an enterprise master configuration:
- Sample output if the command is issued at the enterprise master:
PLEX1 DSIPLX01 NTVE4 NMP219 ACTIVE EM 250 PLEX1 DSIPLX01 NTVE5 NMP219 ACTIVE EC 250 NVDPLEX2 DSIPLX01 NTV52 NMP111 ACTIVE RM 250 NVDPLEX2 DSIPLX01 NTVE1 NMP217 ACTIVE RC 1 NVDPLEX2 DSIPLX01 NTV54 NMP195 ACTIVE RC 50 PLEX1 DSIPLX02 NTVE6 NMP219 ACTIVE RM 250 PLEX1 DSIPLX02 NTVE7 NMP219 ACTIVE RC 1
- Sample output if the command is issued at another member in the
enterprise master's sysplex group:
PLEX1 DSIPLX01 NTVE4 NMP219 ACTIVE EM 250 PLEX1 DSIPLX01 NTVE5 NMP219 ACTIVE EC 250
- Sample output if the command is issued at a NetView outside the enterprise master's sysplex
group:
PLEX1 DSIPLX01 NTVE4 NMP219 ACTIVE EM 251 0 PLEX1 DSIPLX01 NTVE4 NMP219 ACTIVE M 250 5 PLEX1 DSIPLX01 NTVE5 NMP219 ACTIVE C 1 5
- Sample output if the command is issued at the enterprise master:
- If there is no enterprise master:
- Sample output at any of the members of the sysplex group:
PLEX1 DSIPLX02 NTVE6 NMP219 ACTIVE M 250 5 PLEX1 DSIPLX02 NTVE7 NMP219 ACTIVE C 1 5
- Sample output at any of the members of the sysplex group: