Specifying resource names

Before we describe each function in detail, we need to describe how we specify a CICS resource to File Manager. FM/CICS provides specific functions to process your CICS resources. These are referred to as CICS ONLY functions.

When entering the CICS ONLY resource name, the following applies:
Resource name
  • 1–8 character file name
  • 1–16 character temporary storage queue
  • 1–4 character transient data queue

The resource name is used in conjunction with SYSID and POOLNAME (TS queues only) to produce a list of matching resources.

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

CICS temporary storage and transient data queue names can be mixed-case. Therefore, the resource name input fields for these resource types throughout the FM/CICS interface are case sensitive.

Also, CICS temporary storage queue names can contain unprintable characters. To view or enter the TS queue name in hex, place the cursor on the queue name input 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.

SYSID
Default value is blank. This field contains 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 percent sign (%) to represent a single character, and an asterisk (*) to represent any number of characters.
Note: FM/CICS can process CICS resources that are owned by a region other than the region where FM/CICS is running if:
  • An active connection between the current region where FM/CICS is running and the remote region that owns the resource is active, and
  • The FM/CICS program, FMN3CICS, is available on the remote region.
To process a remote CICS resource, you must specify the SYSID that owns the resource on the FM/CICS panels (generics are allowed). A remote definition on the local CICS region for the remote resource is not required by FM/CICS. In addition, specifying a blank SYSID value for a remote CICS resource that is owned by another region causes "not found" condition.

For further information, see the File Manager for z/OS Customization Guide.

TS Pool name
(TS Data sharing only.) Default value is blank. This field is used to specify the pool name of a shared temporary storage pool and temporary storage processing is shipped to a temporary storage server that manages the pool. You can enter a fully-qualified or generic pool name. In a generic pool name, use the percent 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.

A resource selection list is produced when any one of the following conditions is met:
  • A generic resource name is entered
  • A generic sysid value is entered
  • A generic pool name is entered (temporary storage only)
  • A pool name and sysid value are both specified (temporary storage only)