Previous Topic: AccessNext Topic: Browse Panel


File Menu Fields

The following table describes the fields on the File menu. The Modify column indicates if the field can be overtyped while in modify or extended modify mode.

The Sort column indicates that sorting of the display according to the file attribute in the column is possible. Only one column can be sorted at a time. You can apply sort by placing the cursor on the column name and selecting Enter. The default sort order is ascending. Reselecting the column name reverses the sort order.

The Filter column indicates whether filtering on this column can be used to limit the file list to a subset of the total list. An * in any filter indicates that no filter value is currently assigned. In the case of multiple filters, the file attributes must match all of the filters to be displayed. Alphanumeric filters may optionally contain asterisks that match any character in that position. The Filter Type column indicates whether the filter is a numeric or alphanumeric filter.

By default, Numeric and Date filters display files which contain attribute values greater than or equal to the value used as a filter. For numeric attribute values less than the filter value, specify a leading "<" in the filter, such as files that have 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 Pages filter is 99999 and the highest 'less than' filter for Pages is <9999.

In the Date filters, the format of the date in the filter is the same as what is displayed for each file. In the Time portion of the Date filter, only hours and minutes are supported. The use of '<' is supported in the Date filters.

Field

Contents

Modify

Sort

Filter

Filter Type

Action

 

A—Releases the file from Hold status.

N/A

N

N

 

B—Browses the file using ISPF BROWSE. (Only valid in ISPF environments).

 

 

 

 

 

H—Puts the file in hold status and prevents it from printing.

 

 

 

 

M—Modifies the file. Fields that can be modified are highlighted and can be overtyped with new values. The MODIFY command is terminated if scrolling is attempted, and must be re-issued after scrolling.

 

 

 

 

Blank—Selects a file for extended display. Leave the action field blank and press Enter to select a particular file for extended display. This will display all fields for the file and highlight any field that can be modified. This is effectively an extended MODIFY command.

 

 

 

 

N—Creates a new copy of the file in CA Spool. You are presented with a new panel in which you can change some of the fields for the new file. For a complete description of this panel, see the Browse Panel section later in this chapter.

 

 

 

 

P—Purges the file (deletes the file) from CA Spool.

 

 

 

 

R—Removes End-Of-File status from the file. If the file has no other status codes it can now be selected for printing.

 

 

 

 

 

S—Selects a file to browse (this command is valid in all environments).

 

 

 

 

V—Used to view GDDM and AFP files (this is only available under ISPF and CICS). To display the file using the correct fonts, the file named ADMDEFS and ADMSYMBL must be allocated to the TSO user or the CICS started task procedure. Contact your system programmer to determine the data sets to allocate.

 

 

 

 

 

S—Selects a file to browse (this command is valid in all environments).

 

 

 

 

V—Used to view GDDM and AFP files (this is only available under ISPF and CICS). To display the file using the correct fonts, the file named ADMDEFS and ADMSYMBL must be allocated to the TSO user or the CICS started task procedure. Contact your system programmer to determine the data sets to allocate.

 

 

 

 

Seqno

CA Spool file sequence number.

No

Yes

Yes

Numeric

Filename

Identification of the file.

Yes

Yes

Yes

Alphanumeric

Dest

Name or alias of printer to receive the file.

Yes

Yes

Yes

Alphanumeric

Q

Output class

Yes

Yes

Yes

Alphanumeric

Form

Name of the form on which the file is printed.

Yes

Yes

Yes

Alphanumeric

FCB

FCB image describes the page characteristics such as length, width, channels.

Yes

Yes

Yes

Alphanumeric

Pages

Number of pages in the file.

No

Yes

Yes

Numeric

Copy

Number of copies to print.

Yes

Yes

Yes

Numeric

Pr

Output priority in the range 0-15.

Yes

Yes

Yes

Numeric

Sid

System affinity—Used in MAS complexes to show which member of the complex is handling or going to handle the file.

Yes

No

No

 

Status

Current status of the file:

  • A—Active, being printed.
  • E—End of file that normally means printed or read to the end.
  • H—Held, cannot be selected for printing.
  • I—Open for input (being read).
  • O—Open for output (being written to).
  • P—Being purged.
  • S—Queued for CA View interface.
  • T—Temporarily closed, cannot select for printing.
  • W—Awaiting transfer on XFER or NJE interface.
  • X—Being transferred on XFER or NJE interface.
  • Y—Queued for Transformer interface.

No

No

No

 

Lines

Number of print records

No

Yes

Yes

Numeric

Ret

Specifies the period of time in hours that the file must retain after printing.

Yes

Yes

Yes

Numeric

Part/prt

Partial printing—Start page/number of pages: Can be set to print by selecting pages from a file.

Yes

No

No

 

Rmt dest

Remote destination—Used to identify the final destination, such as printer name, when a file is transferred outside the current CA Spool system.

Yes

Yes

Yes

Alphanumeric

Lc

Number of lines to be printed on each page (only valid if the file has no control characters).

Yes

No

No

 

Lrecl

Logical record length as specified when the file was created.

No

Yes

Yes

Numeric

Formd

Name of the FormDef to be used for this file.

Yes

Yes

Yes

Alphanumeric

Paged

Name of the PageDef to be used for this file.

Yes

Yes

Yes

Alphanumeric

Chars

Character arrangement table—Can be used to specify up to four character sets (separated by commas) to be used for this file.

Yes

No

No

 

Prmode

Processing mode:

  • LINE/blank—Normal line mode data that can be printed on any line or page mode printer.
  • PAGE—AFP-data streams, which can be printed on page mode printers only; these are printers driven by PSF, or similar print drivers supported by CA Spool.
  • IPDS—Pre-formatted print data streams, which can only be printed on printers with IPDS support.
  • PCL—PCL print data stream that can only be printed on printers with PCL support.
  • PS—PostScript print data stream, which can only be printed on printers with Postscript support.

No

Yes

Yes

Alphanumeric

User

User ID of the file creator

No

Yes

Yes

Alphanumeric

Account

Account number of the file

No

Yes

Yes

Alphanumeric

Programmer Name

The first 16 bytes of the programmer's name field of the file. This field is often customized, and can contain any value.

No

Yes

Yes

Alphanumeric (see the Note below)

CC

Control Characters:

  • A—ANSI
  • M—Machine
  • T—TRC
  • Blank—none

No

No

No

 

Created

Date and time when the file was originally opened for output.

No

Yes

Yes

Date

Last used

Date and time when file attributes were last modified or when the file was last printed.

No

Yes

Yes

Date

Note: The Programmer Name filter is unique and works in the following manner. The asterisk is a leading value which indicates any number of characters. The percent sign (%) indicates any single character. A percent sign that follows an asterisk is ignored. Multiple asterisks are treated the same as a single asterisk. Additionally, the information stored in the programmer's name field can be searched for a maximum of 60 characters or the value specified for the PGNLEN parameter in ESFPARMS, whichever is lower. For this reason, it is recommended that the CA Spool menu be customized to display the lower of 60 or the value of PGNLEN in ESFPARMS to avoid confusion.