CLOSE subcommand — release resources in use by IPCS

Use the CLOSE subcommand to end the use of a source or data set by IPCS. CLOSE can end the use of the following:

Dump data sets
Trace data sets
User dump directory
Sysplex dump directory (for users with access authority)
Central storage
Print and table of contents (TOC) data sets

Note: When you end an IPCS session, IPCS automatically closes these data sets, except the sysplex dump directory.

See z/OS MVS IPCS User's Guide for information about closing the print and TOC data sets.

Syntax

   CLOSE      { ALL                                    }
              { ACTIVE|MAIN|STORAGE                    }
              { DSNAME(dslist)|DATASET(dslist)         }
              { FILE(ddlist | IPCSDDIR)|DDNAME(ddlist) }
              { PATH(path-name ...)       }
              [ CONDITIONALLY | UNCONDITIONALLY ]
              [ PRINT ]

-------- SETDEF-Defined Parameter -------------------------
Note: You can override the following SETDEF parameter.
See SETDEF subcommand — set defaults.

              [ TEST | NOTEST ]

Parameters
ALL

ACTIVE or MAIN or STORAGE

DSNAME(dslist) or DATASET(dslist)

FILE(ddlist | IPCSDDIR) or DDNAME(ddlist)

PATH(pathname)

Specifies one or more source or print data sets to be closed. If you specify ALL and other source parameters, IPCS processes CLOSE ALL and ignores the other source parameters. If you omit these parameters, IPCS closes your current source data set.
ALL directs IPCS to close all data sets it is using.

ACTIVE, MAIN, or STORAGE directs IPCS to release resources that were needed to access the central storage that was specified as the source.

DSNAME or DATASET specifies one or more names of cataloged data sets that IPCS is to close. The CLOSE subcommand closes the data sets in the order in which they are specified.

FILE or DDNAME specifies one or more ddnames of data sets that IPCS is to close. The CLOSE subcommand closes the data sets in the order in which they are specified.

When specifying more than one data set name or ddname, separate the names with a comma or a blank.

PATH specifies one or more paths of a file or directory on a z/OS® UNIX file.

CLOSE FILE(IPCSDDIR) indicates that you want to close your current dump directory. You have to specify its ddname; specifying a range for ddlist does not include your dump directory.
Default Values: You can change your current dump directory by closing it and opening another. This substitution has no effect on the local or global default values. IPCS establishes the local and global defaults when a session starts, using defaults from the dump directory available when the session started.

If you update your local or global defaults, IPCS records the updated defaults in your current dump directory. Depending on when you make the update, the updated dump directory will be the original directory used when the session started or the substitution dump directory.

CONDITIONALLY or UNCONDITIONALLY

Determines how IPCS should handle a data set that is already closed when the CLOSE subcommand is processed. For CONDITIONALLY, IPCS does not issue messages about the data set being closed. For UNCONDITIONALLY, IPCS issues messages about the data set being closed. UNCONDITIONALLY is the default.

PRINT

PRINT directs IPCS to close the print data set and the table of contents (TOC) data set, if it is open. In the process of doing a CLOSE PRINT, the default message routing parameter is set to NOPRINT so that subsequent subcommands do not attempt to write to a closed data set.
Support of dump directory substitution
- IPCS supports substitution when the change of dump directories is made while you are not using the IPCS dialog.
- IPCS supports substitution while you are using the IPCS dialog when the dialog activity is not using the original dump directory.
- IPCS does not allow substitution while you are using the IPCS dialog when the dialog activity is using the original dump directory. The reason is that unpredictable errors can potentially damage the new directory, because IPCS has data from the original directory and the data is not necessarily present in the new directory.
Return codes
See Standard subcommand return codes for a description of the return codes produced by the CLOSE subcommand.
Example: Close the TOC data set.
- Action
```
COMMAND ===> close print
```
- Result
  Both the TOC and print data sets are closed. Note that when you end an IPCS session, IPCS closes both of these data sets automatically.