Browse Entry panels

Panel and field definitions

  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

  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

  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.