LIST (NCCF)

Syntax

LIST (NCCF)

Read syntax diagramSkip visual syntax diagramLISTAssignOpsCLIST=clist_nameCZFILTERCONNSECDEFAULTSDSILOGDST=dstnameListOpFOCPT=STATUShclnameIPADDR= ip_addressKEY=ALLPAkeyPFkey APPL=current_appl APPL=ALLapplidMemstatMSG=AUTHCOPYoperator_idOPKTOVERRIDE=opidPERSISTPKTSPRIORITYRESOURCE=rnameREXXENVREXXPARMROLLSecuritySECOPTSSPAN=span_nameStatusTASK=tasknameterminal_nameTCPCONNTIMER=ALLreqnameListOpTRACEVIEW=vname*
AssignOps
Read syntax diagramSkip visual syntax diagramASSIGN= AUTH OP=ALLoperid MSGID=ALLmessage_idCOPY OP=ALLoperid MSGID=ALLmessage_idGROUP OP=ALLoperid GROUP=ALLgroupid
ListOp
Read syntax diagramSkip visual syntax diagram OP=* OP=*ALLPPToperid
Memstat
Read syntax diagramSkip visual syntax diagramMEMSTAT= *ddnamemembername  OP=* OP=*ALLPPToperidNONE%
Security
Read syntax diagramSkip visual syntax diagramSAFOP= *opid  SEGMENT=BASE SEGMENT=BASELANGUAGENETVIEWOMVS
Status
Read syntax diagramSkip visual syntax diagramSTATUS= AMLUSESSCANZLOGCNMSESSNNTOPSOPTSPANSTASKSTasksOpsTSOSERVVOSTXCFGRPS GROUP=group_nameDSIPLX* MEMBER= member_name
TasksOps
Read syntax diagramSkip visual syntax diagram EXTEND=0 EXTEND=01 WLM=NO WLM=NOYES RXENVCNT=NO RXENVCNT=NOYES

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:
CONNSEC TCPNAME: tname TASKID: tname
STATUS: ACTIVE|INACTIVE
The variables in the data line are as follows:
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
Other applications using the first parameter on the VIEW command to specify an application name, such as MAINMENU and ACTION command lists, might have PF key settings, which can be displayed. To display default key settings, use applid NETVIEW. To list default keys for VIEW command output panels, use applid VIEW.

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
The active span list contains the access level at which the operator 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 the operator logged on but is not currently in effect, the profile field on the display has a value of NONE.
*
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.
Extend=0 is the default and leaves out these items.
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:
SvcCls: Not Available
or
SvcCls: WLMserviceClassName
where WLMserviceClassName is the WLM service class assigned to the listed NetView subtask.

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

The following usage notes apply to the LIST (NCCF) command:
  • 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.
    To list information from other segments of a user profile, including your own, one of the following conditions must be true:
    • 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

To display your NETVIEW segment data, enter:
LIST SAFOP=*,SEGMENT=NETVIEW
The response is similar to the following example:
* 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

To display SAF BASE segment data for an operator named OPER4, enter:
LIST SAFOP=OPER4
The response is similar to the following example:
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

To display the status of the network log, enter:
LIST DSILOG
The response is similar to the following example:
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

To display a specified command list, for example WTORC, enter:
LIST CLIST=WTORC
The response is similar to the following example:
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

To display the status of a specified operator where OPERSEC=SAFDEF, enter:
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

To display the status of your operator ID, enter:
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

If you have defined a timer with an ID of RCF, you can display it by entering:
LIST TIMER=RCF
The response is similar to the following example:
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
Note: The operator or group name following the 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

To display timer requests from operator OPER1, enter:
LIST TIMER=ALL OP=OPER1
If you have defined timers, you receive a response similar to the previous example. If no timers are in effect, you receive a response similar to the following:
DISPLAY OF OUTSTANDING TIMER REQUESTS
0 TIMER ELEMENT(S) FOUND FOR OPER1
END OF DISPLAY

Example: Displaying Virtual OSTs (VOSTs)

To display the VOSTs on your NetView system, enter:
LIST STATUS=VOST
You receive a response similar to the following:
TASKNAME: DSI#0603  OWNER: OPER2    ATTACHN: NLDM     STATUS: ACTIVE

Example: Displaying the PF1 key setting in the hardware monitor

To display the current hardware monitor key settings, enter:
LIST KEY=PF1 APPL=NPDA

Example: Displaying PF10 Settings for all full-screen applications

To display the PF10 key settings for all applications, enter:
LIST KEY=PF10 APPL=ALL

Example: Displaying the PF key settings for all applications

To display the settings for all keys for all applications, enter:
LIST KEY=ALL APPL=ALL

Example: Displaying the current security options

To display the current security options, enter:
LIST SECOPTS
The response is similar to the following example:
* 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.

Note the following conditions in the previous example:
  • 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

To display the span of control information for SPAN1, enter:
LIST SPAN=SPAN1
The response is similar to the following example:
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

To display the span of control information for resource A01CDRSC, enter:
LIST RESOURCE=A01CDRSC
The response is similar to the following example:
A01CDRSC SPECIFICALLY DEFINED TO SPANS:
       SPAN1, SPAN9, SPAN10

A01CDRSC GENERICALLY DEFINED TO SPANS:
       SPAN7
 

Example: Displaying the current defaults

To display the current defaults, enter:
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

To display members in storage and members that have a non-zero hit count, enter:
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

To display all active TSO servers, enter:
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

To display the status of all enabled PIPE PERSIST elements, enter:
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

For problem determination purposes, you can issue the following command to display the 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

To list the XCF groups in which the NetView program participates, you can enter the following command:
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        
  • 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