Storage control macro-compatibility interface

DFHSMSCP is responsible for handling all requests for storage services that are made by using the routine addressed by CSASCNAC in the CICS® common system area (CSA). DFHSMSCP is called by some parts of the CICS AP domain containing DFHSC macros. DFHSMSCP converts all requests into calls to the storage manager domain, and its main function is to get or free storage.

Design overview

The input to DFHSMSCP, set up by the macro used for the invocation, or directly by the calling program, consists of the following TCA fields.
Field Description
TCASCTR

The storage control request byte.

This can contain one of the following values:
  • X'80' GETMAIN, in conjunction with:
    • X'40' Initialize storage
    • X'20' Conditional
    • Storage class in bits 3 through 7 (the resulting SMMC GETMAIN storage class name is given in parentheses where this differs from the first name):
      • X'00' 1WD, treated as SHARED
      • X'04' LINE
      • X'05' TERMINAL or TERM
      • X'0C' USER (becomes CICS24)
      • X'0D' TRANSDATA or TD
      • X'13' SHARED (becomes SHARED_CICS24)
      • X'14' CONTROL
  • X'40' FREEMAIN, in conjunction with:
    • X'01' TCTTE address supplied
TCASCIB The 1-byte value to which storage is to be initialized
TCASCNB The 2-byte field giving the number of bytes requested on the GETMAIN
TCASCSA The 4-byte address of the storage that was obtained or the storage to be freed

Modules

DFHSMSCP

Exits

No global user exit points are provided for this function.

Trace

The point IDs for this function are of the form AP F1xx; the corresponding trace levels are SC 1 and Exc.