STRCLNUP (Start Cleanup)

STRCLNUP Command syntax diagram

 

Purpose

The Start Cleanup (STRCLNUP) command checks to determine whether the cleanup operation is allowed. The cleanup operation is allowed if ALWCLNUP(*YES) is specified on the Change Cleanup (CHGCLNUP) command.

A batch job that controls the cleanup operation and the power on/off schedule is submitted to the job queue specified on the CHGCLNUP command. This cleanup control job submits individual batch jobs to the same job queue each day at the time specified on the STRTIME parameter of the CHGCLNUP command. These batch jobs do the actual cleanup of the objects specified on the CHGCLNUP command if cleanup is allowed.

More information is in the CHGCLNUP (Change Cleanup) command description and the Basic System Operations topic in the Information Center.

Restriction: The user of this command must have *JOBCTL authority and must be authorized to the QPGMR user profile.

 

Optional Parameters

OPTION

Specifies when the cleanup operation is started.

*SCHED: The cleanup operation is started as specified on the STRTIME parameter of the CHGCLNUP command or on the Change Cleanup Options display.

*IMMED: The cleanup operation is started immediately.

Examples for STRCLNUP

Example 1: Starting Cleanup Operation as Scheduled

STRCLNUP

This command starts the cleanup operation as specified.

Example 2: Starting Cleanup Operation as Specified on CHGLNUP Command

STRCLNUP  OPTION(*SCHED)

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

Example 3: Starting Cleanup Operation Immediately

STRCLNUP  OPTION(*IMMED)

This command starts the cleanup operation immediately.

Error messages for STRCLNUP

*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.