Start Cleanup (STRCLNUP)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Start Cleanup (STRCLNUP) command starts the cleanup operation, if allowed. Cleanup is allowed if *YES is specified for the Allow cleanup (ALWCLNUP) parameter of the Change Cleanup (CHGCLNUP) command.

A batch job is submitted to the job queue specified on the Change Cleanup (CHGCLNUP) command if cleanup is allowed. This cleanup control job submits individual batch jobs to the same job queue each day These batch jobs do the actual cleanup of the items specified on the CHGCLNUP command.

More information is in the Basic System Operation information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Restriction: You must have job control (*JOBCTL) special authority and have at least *USE authority to the QPGMR user profile to use this command.

Top

Parameters

Keyword Description Choices Notes
OPTION Option *SCHED, *IMMED Optional, Positional 1
Top

Option (OPTION)

Specifies when the cleanup operation is started.

*SCHED
The cleanup operation is started as scheduled for the Time cleanup starts each day (STRTIME) parameter of the Change Cleanup (CHGCLNUP) command or as scheduled on the Change Cleanup Options display.
*IMMED
The cleanup operation starts immediately.
Top

Examples

Example 1: Starting Cleanup Operation as Scheduled 

STRCLNUP

This command starts the cleanup operation as specified.

Example 2: Starting Cleanup Operation as Specified on CHGCLNUP Command 

STRCLNUP   OPTION(*SCHED)

This command starts the cleanup operation as specified on the STRTIME parameter of the Change Cleanup (CHGCLNUP) command or on the Change Cleanup Options panel.

Example 3: Starting Cleanup Operation Immediately 

STRCLNUP   OPTION(*IMMED)

This command starts the cleanup operation immediately.

Top

Error messages

*ESCAPE Messages

CPF1E2A
Unexpected error in QSYSSCD job.
CPF1E2B
Power scheduler and cleanup options not found.
CPF1E3A
Not authorized to start cleanup.
CPF1E3C
Job queue &2/&1 not found.
CPF1E3D
Library &1 for JOBQ parameter not found.
CPF1E33
Cleanup options or power schedule in use by another user.
CPF1E34
Error occurred starting &1 job.
CPF1E36
Cleanup has not been started.
CPF1E37
Cleanup has already been started or is scheduled to run.
CPF1E38
Cleanup not allowed to run.
CPF1E39
Not authorized to job queue used for cleanup.
CPF1E99
Unexpected error occurred.
Top