Print Entry panels

You use the Print Entry panels to enter the name of a resource to be browsed. You also use these panels to specify the name of the copybook or template that describes a logical view of the data set.

There are three different Print Entry panels. The type of Print Entry panel that FM/CICS displays depends on which CICS Resource you selected on the previous panel (Utility Functions or Primary Option Menu):
Table 1. Print Entry panels
CICS Resource Print Entry panel displayed
File Print CICS File Entry panel
Temporary Storage Print Temporary Storage Entry panel
Transient Data Print Transient Data Entry panel

Each of the Print Entry panels is shown below, followed by a list of entry fields covering all three panels. Most of the entry fields are common to all three panels. Where an entry field is not common to all three panels, the panel to which it applies is indicated.

Panel and field definitions

Figure 1. Print CICS File Entry panel
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 FM/CICS                  Print CICS File Entry Panel

 Input CICS VSAM File:
    File name . . . . . . .         
    Sysid . . . . . . . . .     
    Start key . . . . . . .                                key or slot
    Skip  count . . . . . .              number of records to be skipped
    Print count . . . . . . ALL          number of records to be printed

 Copybook or Template:
    Data set name . . . . .                                               
    Member  . . . . . . . .              (Blank or pattern for member list)

 Processing Options:
    Print Option    Copybook/template/access    Enter "/" to select option
       1. Char      3  1. Above                    Edit template    Type (1,2,S)
       2. Hex          2. Previous                 Use proc         
       3. Sngl         3. None
       4. Tabl         4. Create dynamic           Additional print options


  Command ===>                                                Applid           
 F1=Help     F3=Exit     F4=Expand   F7=Backward F8=Forward  F10=Actions
 F12=Cancel
Figure 2. Print Temporary Storage Entry panel
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 FM/CICS              Print Temporary Storage Entry Panel

 Input Temporary Storage Queue:
    Queue name  . . . . . .                   (Case sensitive)
    Sysid . . . . . . . . .     
    Pool name . . . . . . .         
    Skip  count . . . . . .              number of records to be skipped
    Print count . . . . . . ALL          number of records to be printed

 Copybook or Template:
    Data set name . . . . .                                               
    Member  . . . . . . . .              (Blank or pattern for member list)

 Processing Options:
    Print Option     Copybook/template/access      Enter "/" to select option
       1. Char       3  1. Above                      Edit template
       2. Hex           2. Previous                   Use proc         
       3. Sngl          3. None
       4. Tabl          4. Create dynamic         Additional print options

  Command ===>                                                Applid           
 F1=Help     F3=Exit     F4=Expand   F7=Backward F8=Forward  F10=Actions
 F12=Cancel
Figure 3. Print Transient Data Entry panel
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 FM/CICS                Print Transient Data Entry Panel

 Input Transient Data Queue:
    Queue name  . . . . . .              (Case sensitive)
    Sysid . . . . . . . . .     
    Skip  count . . . . . .              number of records to be skipped
    Print count . . . . . . ALL          number of records to be printed

 Copybook or Template:
    Data set name . . . . .                                               
    Member  . . . . . . . .              (Blank or pattern for member list)

 Processing Options:
    Print Option     Copybook/template/access      Enter "/" to select option
       1. Char       3  1. Above                      Edit template
       2. Hex           2. Previous                   Use proc         
       3. Sngl          3. None
       4. Tabl          4. Create dynamic         Additional print options

 Command ===>                                                Applid            
 F1=Help     F3=Exit     F4=Expand   F7=Backward F8=Forward  F10=Actions
 F12=Cancel
File name (CICS resource: File only)
The 1–8 character name of the file you want to print. It is used in conjunction with Sysid to produce a list of matching resources.

You can enter a fully-qualified or generic resource name. In a generic resource, use the percentage sign (%) to represent a single character, and an asterisk (*) to represent any number of characters.

Queue name (CICS resource: Temporary Storage only)
The 1–16 character name of the temporary storage queue you want to print. It is used in conjunction with Sysid to produce a list of matching resources.

You can enter a fully-qualified or generic resource name. In a generic resource, use the percentage sign (%) to represent a single character, and an asterisk (*) to represent any number of characters.

This input field is case sensitive.

To view or enter the hex value of a TS queue name, place the cursor on the field and enter the EXPAND primary command (or equivalent function key). Enter the HEX ON command from within the expand pop-up panel to view and enter hex values.

Queue name (CICS resource: Transient Data only)
The 1–4 character name of the transient data queue you want to print. It is used in conjunction with Sysid to produce a list of matching resources.

You can enter a fully-qualified or generic resource name. In a generic resource, use the percentage sign (%) to represent a single character, and an asterisk (*) to represent any number of characters.

This field is case sensitive.

Sysid
The ID of the CICS systems where the resource resides. A blank value defaults to the local system.

You can enter a fully-qualified or generic sysid. In a generic sysid, use the % sign to represent a single character, and an asterisk (*) to represent any number of characters.

Pool name (CICS resource: Temporary Storage only)
The TS pool name of a shared temporary storage pool and temporary storage processing shipped to the temporary storage server that manages the pool.

You can enter a fully-qualified or generic pool name. In a generic pool name use the percentage sign (%) to represent a single character, and an asterisk (*) to represent any number of characters.

If you specify a Sysid value and a TS Pool name, then a list of queues that match either is produced from which you can select the appropriate queue for processing.

Start key (CICS resource: File only)
The starting key or slot location for a VSAM file

This field is scrollable and can be expanded with the EXPAND primary command (or equivalent function key). See Scrollable input and display fields for long names.

Skip count
The number of records to be skipped before processing begins
Print count
The number of records to be printed
Copybook or Template: Data set name and Member
These fields identify either a copybook or a template to be used to select records and format the print output. If a copybook is specified, it is compiled to create a temporary template that can optionally be saved if edit was requested.
Print Option
The format of the printed output:
Char
Records are printed in character format.
Hex
Records are printed in hexadecimal format. The DUMP processing option on the Set Processing Options panel determines how HEX data is printed. See Set Processing Options panel.
Sngl
Single record format (one field on each line of the display). The left-hand side of the printout contains the field or header names. The right-hand side contains the field values formatted according to the field type. A template is required for this option.

In this print format, additional field information (redefined fields, field reference number, field type and length values, picture clause, start location, structure) can be printed depending on the Edit/Browse options. Numeric fields can be left-justified depending on the options.

Tabl
Tabular format (fields printed across the display). The records are displayed in columns with field or heading names as column headers and the data formatted according to the field types. In this format, the display might be truncated depending on the current print width. A template is required for this option.
Copybook/template/access
Use this option to specify if you want to use a template, or how records are to be printed.
Above
FM/CICS uses the template specified on the panel. (If you specified a copybook, then File Manager compiles the copybook into a template before use.)
Previous
FM/CICS uses the last template you used to process this resource. If you have not previously used a template for this data set, a message is displayed and processing continues without using a template.
None
FM/CICS does not use a template. SNGL and TABL print formats are not available.
Create dynamic
FM/CICS creates a dynamic template. You can now define fields and field creation attributes.
Edit template
FM/CICS opens the template you have specified for editing, before processing the panel.
Note: For details about using templates, see Creating and editing templates in the File Manager User’s Guide and Reference.
Type (1,2,S)
The type of editing you want to perform.
You can specify one of the following values:
1
Edit the Record Identification Criteria by field first
2
Edit the Record Selection Criteria by field first
S
Edit the source definition for a template using the advanced copybook selection facility.

This option is ignored when editing a dynamic template.

Use proc
Use this option to specify a procedure to search and change the data, rather than using the Find and Change commands. When you select the option, you can perform one of these actions:
  • Choose to create a temporary procedure for one-time use by entering a single asterisk (*). FM/CICS displays an Edit panel, in which you can create the procedure.
  • Specify the name of the member containing the procedure you want to use. The member must belong to the PDS allocated to ddname FMNEXEC. You can enter any of the following:
    • The name of the member.
    • A member name pattern (other than a single *) to list all matching members. You can then select the required member by entering an S in the Sel field. A member name pattern can consist of any characters that are valid in a member name and the following two special pattern characters:
      asterisk (*)
      Represents any number of characters. As many asterisks as required can appear anywhere in a member name. For example, if you enter *d*, a list of all members in the data set whose name contains “d” is displayed.
      percent sign (%)
      A place-holding character representing a single character. As many percent symbols as necessary can appear anywhere in a member name. For example, if you enter %%%%, a list of all members in the data set whose name is four characters in length is displayed.
Note: If you select this option but leave the Use proc member entry field blank, File Manager displays a member name list. You can then select the required member by entering S in the Sel field.

(Also, see Supplying a procedure when using a File Manager panel in the File Manager User’s Guide and Reference.)

Additional print options
Displays the Print Options panel allowing you to specify additional print options.

Parent panels

Child panels

  • Print Options panel in the File Manager User’s Guide and Reference

Related tasks