Browse Entry panels

You use the Browse 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 Browse Entry panels. The type of Browse Entry panel that FM/CICS displays depends on which CICS Resource you selected:
Table 1. Browse Entry panels
CICS Resource Browse Entry panel displayed
File Browse CICS File Entry panel
Temporary Storage Browse Temporary Storage Entry panel
Transient Data Browse Transient Data Entry panel

Each of the Browse Entry panels is shown below, followed by a list of entry fields covering 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. Browse CICS File Entry panel
  Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 FM/CICS                  Browse CICS File Entry Panel

 Input CICS VSAM File:
    File name  . . . .         
    Sysid  . . . . . .     
    Start position . .                               
    Record limit . . .              Record sampling   
 Copybook or Template:
    Data set name  . .                                               
    Member . . . . . .              Blank or pattern for member list
 Processing Options:
  Copybook/template   Start position type   Enter "/" to select option
  3  1. Above            1. Key                Edit template    Type (1,2,S)
     2. Previous         2. RBA                Include only selected records
     3. None             3. Record number
     4. Create dynamic



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

 Input Temporary Storage Queue:
    Queue name . . . .                   (Case sensitive)
    Sysid  . . . . . .     
    Pool name  . . . .         
    Start position . .              Record number
    Record limit . . .              Record sampling   
 Copybook or Template:
    Data set name  . .                                               
    Member . . . . . .              Blank or pattern for member list
 Processing Options:
  Copybook/template       Enter "/" to select option
  3  1. Above                Edit template    Type (1,2,S)
     2. Previous             Include only selected records
     3. None
     4. Create dynamic


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

 Input Transient Data Queue:
    Queue name . . . .              (Case sensitive)
    Sysid  . . . . . .     
    Start position . .              Record number
    Record limit . . .              Record sampling   
 Copybook or Template:
    Data set name  . .                                               
    Member . . . . . .              Blank or pattern for member list
 Processing Options:
  Copybook/template       Enter "/" to select option
  3  1. Above                Edit template    Type (1,2,S)
     2. Previous             Include only selected records
     3. None
     4. Create dynamic



 Command ===>                                                Applid            
 F1=Help     F3=Exit     F4=Expand   F7=Backward F8=Forward  F10=Left
 F11=Right    F12=Cancel
File name (CICS resource: File only)
The 1–8 character name of the file you want to browse. 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 browse. It is used in conjunction with Sysid and Pool name 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.

A CICS temporary storage queue name can contain mixed-case and unprintable characters. Therefore, 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 browse. 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.

A CICS transient data queue name can contain mixed-case characters. Therefore, this input 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 position
Initial starting position for the data set to be browsed. The initial display is positioned at the specified record.

The default is the top of the data set. You can enter a negative record to indicate the number of records before the end of file. For example, to see just the last record on the file, enter -1 as the start point.

The format of the start position field is either numeric or character, depending upon the type of start position selected. For VSAM KSDS Key values, if the value you enter contains leading, embedded or trailing blanks, commas or quotation marks, it must be enclosed in quotation marks. You may also enter a hexadecimal string enclosed in quotation marks and preceded by X or x, for example, X'C1C2'.

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.

For all other data set formats, a valid unsigned number must be entered.

To specify a starting position as the number of records before the end of file, enter a negative record number. For example, to see just the last record on the file, enter a start position of -1.

If you specify a starting position, you should also specify the Start position type in the Processing Options. If you do not, File Manager assumes that the value provided in the Starting position field is a record number.

VSAM - KSDS: Key value
If the key is not matched, the record with a key greater than the value given is specified. If the key value is greater than the last record in the data set, the “Position not found” condition is returned.
VSAM - ESDS: RBA (Relative Byte Address) Value
If the RBA is not matched, the record with a RBA greater than the value given is specified. If the RBA value is greater than that of the last record in the data set, the "Position not found? condition is returned.
VSAM - RRDS: Slot value
If the slot number is greater than the last used slot in the data set, the “Position not found” condition is returned.
Queues — temporary storage and transient data
For queues, the start position is the record number. If the specified record number is greater than the number of records in the queue, the “Position not found” condition is returned.
Record limit
This field restricts the number of records retrieved from a data set (from the start point or top) resulting in an edit of a portion of the data set. You can use the keyword MEMORY as a record limit to restrict the number of records retrieved to as many as will fit comfortably in the available virtual storage.

The default start position is the top of the data set.

Record Sampling
Indicates whether you want record sampling to be performed on the data set. If you select this option, FM/CICS displays the Record Sampling panel.
Copybook or Template
Data set name and Member name of the template or copybook to be used to format your data.
Note: In the case of a copybook, this can be the name of a CA-Panvalet library, or a library accessed using the Library Management System Exit.
Copybook/template usage
Indicates if you want to use a template for a logical view of the data.
1
Use the template specified on the panel (or compile the specified copybook into a template, and use that).
2
Use the last template associated with the data set.
3
No logical view is to be used by the function.
4
Create a dynamic template.
Start position type (CICS resource: File only)
Determines how FM/CICS interprets the value provided in the Starting position field. If the Start position type is not specified, FM/CICS assumes that the value is a Record Number.
1. KEY
Only valid when the data set is a VSAM KSDS, VSAM AIX® or VSAM PATH.
2. RBA
Only valid when the data set is a CICS VSAM ESDS.
3. Record Number
Default. Valid for any type of supported data set.
Edit template
Indicates if you want to edit the template before use. You edit the template when you need to change format, selection, data create attributes, and reformatting information for output copy templates.
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.

Include only selected records
When the FM/CICS editor session is either in-storage (a record limit of MEMORY is used) or when you have selected Record Sampling, only the records selected by template processing are included in the Edit or Browse session.

This option does not alter the operation of the FM/CICS editor session if a template is not used.

Use I/O exit
Allows you to specify a user I/O exit for compressed or encrypted data sets.

This option has two fields. To select the option, enter "/" in the field to the left of Use I/O exit. With this selected, you can then specify which exit to use in the field to the right of the field label.

Note:
  1. The fields only display if File Manager is installed with the option USEIOX=ENABLE, and the Exit enabled field (in the Set System Processing Options panel) is set to YES. If a default is specified with either of those options, it is displayed in the field to the right of Use I/O exit.
  2. I/O exits can only be used to process the data sets that you are using. They cannot be used to process the copybook or template that you are using to format the data set.

Parent panels

  • Primary Option Menu panels (when you enter DSB on the command line.)
  • When you use the B prefix command in a list of CICS resources.

Child panels

The next panel displayed depends on the options selected in the Browse CICS File Entry panel.

Related tasks