SET STORECLR

Read syntax diagramSkip visual syntax diagram SET STORECLR ENDCMDENDSVC

Authorization

General User

Purpose

Use the SET STORECLR command to set the point of automatic GETMAIN storage cleanup and determine the action for user invocation of the CMS STRINIT macroinstruction.

Operands

ENDCMD
indicates CMS returns GETMAIN storage at end-of-command (the point where the CMS ready message (Ready;) is displayed) and CMS honors user invocations of STRINIT and EXECOS.
ENDSVC
indicates CMS returns GETMAIN storage at SVC 202, SVC 204/CMSCALL, and SVC 42/ATTACH termination. ENDSVC also indicates CMS treats user invocations of STRINIT and EXECOS as a NOP.

Initial Setting

ENDSVC

Usage Notes

  1. Changing the setting causes CMS to release any GETMAIN storage currently on the SVC chain.
  2. Use the QUERY STORECLR command to determine the current setting of STORECLR.
  3. This command does not affect the method of GETMAIN storage cleanup at ABEND recovery. All GETMAIN storage is reclaimed at ABEND.
  4. If an entire system must retain GETMAIN storage, place the SET STORECLR ENDCMD command in the SYSTEM profile. If a particular virtual machine must retain GETMAIN storage, place the SET STORECLR ENDCMD command in the user's PROFILE EXEC. For a particular application, you can switch STORECLR from ENDCMD to ENDSVC and back using the CMSCALL macro for assembler programs, or by using a front-end EXEC.
    Note: When you use the SET STORECLR command to change the current setting, a STRINIT is performed and existing OS/MVS GETMAIN storage is cleaned up.

Messages and Return Codes

Return codes:

RC
Meaning
0
Normal completion.
24
A not valid parameter was specified on the SET STORECLR command.

System messages may be issued by this command. The reasons for these messages and their location are:

Reason Location
Errors in command syntax. Command Syntax Error Messages