Previous Topic: Action FieldNext Topic: Combined Printer and File Display Panel

Menu System › Printer Display Panel › Using Filtering Criteria › Action Field › Example

Example

This example illustrates an extended modify display of a printer as selected by the blank action command. You can modify all fields that are highlighted by overtyping the field.

                                                                   Spool    (QA44 )             Printers                  Ln     1 -     1 /     1
Sub QA44 Nje          RN          RG       RU          Col    1 to   60 of  272
-------------------------------------------------------------------------------
          *                               *                                    
Action    Dest     Q        Form     Fcb  Status                Pages  Printed 
          A18P1030 A        STD      6    DRAINED                              
                                                                               
                   A P S R    Lines  Printed Trans    Type     Info Alias      
                   Y N 1 Y                            3287                     
                                                                               
                   Group Snabu Maxda Logmode  User parm        Nje dest        
                       1  4096  4096                                           
                                                                               
                   Location         Transform  TCP Driver  Port                
                                                                               
                                                                               
                   TCP/IP host address              TCP/IP printer name        
                                                                               
                                                                               
-------------------------------------------------------------------------------
                                                                               
Command ===> 

The following table describes the filtering criteria in the column heading of the printer display. You can set criteria by entering a command in the input field. An asterisk "*" means that no value is currently assigned. The filter value may optionally contain asterisks, which indicates any character is a match in that position. If a printer attribute can be specified in mixed case, the filter is a mixed case filter and the exact match is required.

The Sort column indicates if sorting of columns according to the printer attribute is possible. Only one column can be sorted at a time. The sort is invoked by placing the cursor on the column name and hitting Enter. The initial sort order is ascending. Reselecting the sort column causes the sort order to be reversed.

By default, Numeric filters display files that have attributes greater than or equal to the value used as a filter. For a numeric value less than a filter value, specify '<' before the filter value, for example, files with priority values '<9'. If a 'less than' filter is used in a numeric filter, the maximum number allowed will not always be 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.

Field

Contents

Modify

Sort

Filter

Filter Type

Dest

Printer name

No

Yes

Yes

Alphanumeric

Q

The current output classes that can be selected. Up to 8 classes can be specified. If All is specified, all classes are selected

Yes

Yes

Yes

Alphanumeric

Form

The form that is currently mounted on the printer.

Yes

Yes

Yes

Alphanumeric

Fcb

The FCB that is currently in use must match the form on the printer

Yes

Yes

Yes

Alphanumeric

A

Automatic file selection mode. Values are:

  • Y—If no more files match the criteria in the WS field, any file destined for the printer is selected.
  • N—Printer selects files that match the criteria in the WS field only.

Yes

No

No

 

P

Purge mode. Valid values are:

  • Y—Purges files (deletes files) immediately after printing.
  • N—Retains files after printing until their retention time expires.

Yes

No

No

 

R

Restricted mode. Valid values are:

  • Y—Printer only selects files destined for this printer.
  • N—Printer selects files destined for any printer within the same network group.

Yes

No

No

 

Pages

Total number of pages to be printed for the current file.

No

No

No

 

Printed

Number of pages printed for the current file.

No

No

No

 

Status

Current Status Of Printer. Valid Values Are:

  • ACTIVE FILE (999)—Printer Is Busy Printing File 999.
  • DRAINED—Printer Is Not In CA Spool Session.
  • DRAINING—VTAM Session Is being terminated; current work will be completed.
  • EDRAINED—Printer is no longer in session due to a previous error. You can find more information by investigating the information field of the printer display or enter? in the printer's action field.
  • GDDM—GDDM driver to print a graphic file.
  • HALTED—Printer halted with the Z command.
  • HALTED (SETUP)—Printer halted because file selected for printing does not match printer setup.
  • HALTING—Printer is being halted; current work will be completed.
  • INACTIVE—Printer is in session with CA Spool, but no files meet the selection criteria.
  • INTREQ—Intervention required; printer requires operator attention (for example, out of paper).
  • QUEUED—CA Spool is waiting for connection; printer may be in use by another application.

No

No

Yes

Alphanumeric (see the previous Note about NEVERUSED and NEVEROK).

Lines

Total number of lines in current file.

No

No

No

 

Printed

Number of lines printed for the current file.

No

No

No

 

Trans

Selects printers with a matching Translate Table assignment.

Yes

Yes

Yes

Alphanumeric

Type

Selects printers with a matching Device Type.

No

Yes

Yes

Alphanumeric

Info

Last VTAM sense code, last TCP/IP status code, or last TCP/IP PJL status code.

No

No

No

 

Alias

Alias name of the printer

No

No

No

 

Group

Number of the network group to which the printer belongs.

No

Yes

Yes

Numeric

Snabu

SNA buffer size

No

No

No

 

Maxdata

Max RU-size to be sent to the printer.

No

No

No

 

Logmode

Name of the logmode entry as defined in CA Spool.

No

No

No

 

User Parm

User field as defined in the ESFPARM data set.

No

Yes

Yes

Alphanumeric

Nje dest

NJE destination; used to route files being created for this printer to whatever destination is specified in this field. This value is intended to be an NJE node name, but could be another printer defined in this CA Spool system.

Yes

Yes

Yes

Alphanumeric

Location

Printer Location

No

Yes

Yes

Alphanumeric

Transform

Transformer Options

No

Yes

Yes

Alphanumeric

TCP Driver

TCP/IP Print Driver Options

No

Yes

Yes

Alphanumeric

Port

TCP/IP port number

No

Yes

Yes

Numeric

TCP/IP Host Address

TCP/IP host name or address

Yes

Yes

Yes

Alphanumeric

TCP/IP Printer Name

TCP/IP printer queue name

No

Yes

Yes

Alphanumeric

C-Qcnt

Current queue count

No

Yes

Yes

Numeric

M-Qcnt

Maximum queue length

No

Yes

Yes

Numeric

C-Files

Current hour's files printed

No

Yes

Yes

Numeric

C-Pages

Current hour's pages printed

No

Yes

Yes

Numeric

C-Lines

Current hour's records printed

No

Yes

Yes

Numeric

C-Busy

Percentage of time this printer has been busy in the current hour.

No

Yes

Yes

Numeric

M-Files

Highest number of files printed in any hour since CA Spool was started.

No

Yes

Yes

Numeric

M-Pages

Highest number of pages printed in any hour since CA Spool was started.

No

Yes

Yes

Numeric

M-Lines

Highest number of records printed in any hour since CA Spool was started.

No

Yes

Yes

Numeric

M-Busy

Highest percentage busy in any hour since CA Spool was started.

No

Yes

Yes

Numeric

T-Files

Total files printed

No

Yes

Yes

Numeric

T-Pages

Total pages printed

No

Yes

Yes

Numeric

T-Lines

Total records printed.

No

Yes

Yes

Numeric

Note: The 'Q' (class) filter works differently than the other alphanumeric filters. The existence of the value in the filter, regardless of its position in the Node statement class parameter, causes a match. In other words, if the Node statement Q parameter is specified as Q=ABC, a filter value of B will cause a match. In addition, any nodes that specify Q=ALL will always be returned regardless of the filter value. A filter value of ALL returns only nodes that have Q=ALL specified.