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:
- You can use the LIST ALLOC command to display a list of allocated resources.
- You can use the DUMP /resname command to dump the storage, data queue, or cache list for an allocated resource.