ALLOC (allocating a resource)

The ALLOC command allocates a resource so that you can refer to it by name in completing MALs.

The resource can be a cache list, a data queue, data space storage, or shared CICS storage.

The format of the ALLOC command is:
ALLOC /resname [optional parameters…]
where:
/resname
Identifies the resource being allocated. The resource name can be no more than eight characters, including the required slash.

The optional parameters are:

QUEUE compid
Creates a queue token and assigns it to the resource being allocated. compid is the 3-character component identifier, as listed in Major components of CICSPlex SM.
CLIST
Displays the Allocate CACHE LIST input panel (shown in Figure 1), which lets you create a CACHE LIST token and assign it to the resource being allocated.
STG size [BELOW]
Acquires an address of the specified size from CICS shared storage and assigns it to the resource being allocated. size is a number of bytes. The BELOW option requests storage from below the 16MB line; by default, storage is acquired above the line (in 31-bit mode).
EPTR size
Acquires a data space pointer of the specified size from a data space and assigns its ALET and OFFSET to the resource being allocated. size is a number of bytes.
Figure 1. Allocate CACHE LIST panel
COD1 CICSPlex SM Debugger
CMD=>                                                            Scroll=> PAGE
 
Allocate CACHE LIST
 
     Id of CACHE to create CACHE LIST: /@CACHE           (Optional)
 
     Estimated number of elements:
 
     Element size:
 
     Estimated free space:        (Optional)
 
     GENERIC if generic keys:          (Optional)
 
     Hash Table Size:        (Optional)
 
     Key Offset: 0      (Default 0)
 
     Key Size:
 
     Search method (BINSRCH/HASH): BINSRCH
 
Resources remain allocated across multiple COD0 transactions or between multiple COD0 transactions running concurrently in the same CICS® system. In fact, all resources exist until you specifically purge them.
Note:
  1. You can use the LIST ALLOC command to display a list of allocated resources.
  2. You can use the DUMP /resname command to dump the storage, data queue, or cache list for an allocated resource.


eyus1dy.html | Timestamp icon Last updated: Monday, 5 June 2017