D Command - Display Network Nodes

Use this D command to display the status of one or more network nodes.
spool
Use this D command to display the status of one or more network nodes.
This command has the following format:
D,{
nodename
| *ALL | *ACT} [,N | ,P | ,V] [,PFX=] [,REL=] [,NUM=] [,ST=] [,C=] [,F=] [,G=] [,L=] [,Q=] [,U=] [,A2=] [,DT=] [,PQ=] [,PT=] [,TD=] [,TH=] [,TT=] [,CQ=] [,MQ=] [,CF=] [,CP=] [,CL=] [,CB=] [,MF=] [,MP=] [,ML=] [,MB=] [,TF=] [,TP=] [,TL=] [,TB=] [,S=] [,O=]
Parameter notes
  • If a
    nodename
    is specified, the status of only that node is displayed.
  • If the keyword *ALL is specified, all P, D, N, or V nodes are displayed. If none [of the indicated operands] is specified, the default is to display all printer nodes.
  • If the keyword *ACT is specified, all active P, D, N, or V nodes are displayed. If none [of the indicated operands] is specified, the default is to display active printer nodes.
  • If the N operand is specified, only the NJE nodes are displayed.
  • If the P operand is specified, only the printer nodes are displayed.
  • If the V operand is specified, only the virtual printer nodes are displayed.
  • The PFX=
    cccccccc
    keyword specifies 1 to 8 characters long prefix.
  • The REL=
    nnnnnn
    keyword starts the display at a point relative to the normal start of the display.
  • The NUM=
    nnnnnn
    keyword limits the display to a certain number of replies.
  • The ST=Status filter can be up to 18 characters long and limits the display to the nodes in a status that begin with the characters specified. This operand applies to printer and virtual printer nodes only.
  • The C= keyword filters printer nodes by their FCB attribute.
  • The F= keyword filters printer nodes by their FORM attribute.
  • The G= keyword filters printer nodes by their valid network group number.
  • The L= keyword filters printer nodes by their LOCATION attribute.
  • The Q= keyword filters printer nodes by their CLASS attribute.
  • The U= keyword filters printer nodes by their USERPARM attribute.
  • The A2= keyword filters printer nodes by their TRANSFRM attribute.
  • The DT= keyword filters printer nodes by their device type.
  • The PQ= keyword filters printer nodes by their TCPPRT attribute.
  • The PT= keyword filters printer nodes by their TCPPORT attribute.
  • The TD= keyword filters printer nodes by their TCPDRIV attribute.
  • The TH= keyword filters printer nodes by their TCPHOST attribute.
  • The TT= keyword filters printer nodes by their Translate Table attribute.
  • The CQ= keyword filters printer nodes by their current queue count.
  • The MQ= keyword filters printer nodes by their maximum queue count.
  • The CF= keyword filters printer nodes by the files printed in the current hour.
  • The CP= keyword filters printer nodes by the pages printed in the current hour.
  • The CL= keyword filters printer nodes by the lines printed in the current hour.
  • The CB= keyword filters printer nodes by percentage of time this printer has been busy in the current hour.
  • The MF= keyword filters printer nodes by highest number of files printed in any hour after
    Spool
    was started.
  • The MP= keyword filters printer nodes by highest number of pages printed in any hour after
    Spool
    was started.
  • The ML= keyword filters printer nodes by highest number of records printed in any hour after
    Spool
    was started.
  • The MB= keyword filters printer nodes by highest percentage busy in any hour after
    Spool
    was started.
  • The TF= keyword filters printer nodes by total files printed.
  • The TP= keyword filters printer nodes by total pages printed.
  • The TL= keyword filters printer nodes by total records printed.
  • The TB= keyword filters printer nodes by total percentage of time this printer has been busy.
  • The S= keyword specifies the column to be sorted.
  • The O= keyword specifies the sort order.
When displaying printer nodes, the "ST=status filter" field can be specified as any of the status names as shown on the display panel status field, such as DRAINED, ACTIVE, INACTIVE, or as NEVERUSED or NEVEROK.
For example, to display those printers that have not had any files queued or selected, a D,*ALL,P,ST=NEVERUSED command is issued.
To display those printers that have not had a file successfully printed, a D,*ALL,P,ST=NEVEROK command is issued.
The printer use status of NEVERUSED and NEVEROK is maintained throughout the
Spool
cycle. For instance, the use status of printers is maintained across REINIT processing, but not across a cold or warm start of
Spool
. If you are using MAS or EMAS environment, the network control is switched to a different member and the use status of printers is lost.
When displaying virtual printer nodes, the "ST=status filter" must be specified as shown on the printer menu display only.
The C, F, L, Q, U, A2, DT, PQ, TD, TH, and TT filters apply only to printer nodes. Their length is limited to the length of the filtering attribute. The case of the filter matches the case of the attribute. For example, FCB's must always be in uppercase so the C filter is also an uppercase filter. Location can be mixed case so the L filter must match the case of the printer's location parameter.
The G, PT, CQ, MQ, CF, CP, CL, CB, MF, MP, ML, MB, TF, TP, TL and TB filters apply only to printer nodes. These filters are numeric.
Numeric filters, by default, show files whose attributes are greater than or equal to the value used as a filter. It is possible to show files whose numeric attribute value is less than the filter value by specifying a leading '<' in the filter, such as files whose priority values are '<9'. If a 'less than' filter is used in a numeric filter, the maximum number allowed is not always the highest possible value for the field. For example, the highest number that can be placed in the Port filter is 32767. The highest 'less than' filter for Port is <9999.
The G and PT filter lengths are limited to the length of the filtering attribute. The CQ, MQ, CF, CP, CL, CB, MF, MP, ML, MB, TF, TP, TL filter lengths are limited to the length of the filter in the menu display.
The valid values for S=
Sort value
parameter are equal to the filter parameters with one exception. For example, to sort on TCPHOST specify S=TH. The exception applies for sorting on destination. S=P sorts the printer name.
The O=
Sort order
parameter has two valid values: A for ascending and D for descending order.
Examples
This example displays the status of all printer nodes.
D,*ALL
This example displays the status of all active NJE nodes.
D,*ACT,N
This example displays the status of network node DEPTPRT1.
D,DEPTPRT1
This example displays the status of the first five printer nodes.
D,*ALL,NUM=5
This example displays the status of five printer nodes starting from the sixth printer node.
D,*ALL,REL=6,NUM=5