Start Disk Storage Management (STRDSMOND)

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

The Start Disk Storage Management (STRDSMOND) command starts the Disk Storage Management (DSM) task which manages the movement of OnDemand data on disk and between disk and the Archived Storage Manager (ASM). DSM also controls the expiration of data in OnDemand. This function can be canceled with a controlled cancel option if enough time is allowed to end what it is currently processing.

Top

Parameters

Keyword Description Choices Notes
APPGRP Application group Character value Optional, Positional 1
MGROPT Migration options *DATA, *INDEXES, *ALL, *NONE Optional
EXPOPT Expiration options *ALL, *DATA, *INDEXES, *IMPIDX, *NONE Optional
STRASMOND Run ASM *YES, *NO Optional
POLICY Policy Character value Optional
INSTANCE Instance Character value, *DFT Optional
STRSVR Start instance server *NO, *YES Optional
SBMJOB Submit to batch *YES, *NO Optional
JOBD Job description Qualified object name Optional
Qualifier 1: Job description Name, QOND400
Qualifier 2: Library Name, QRDARS, *LIBL, *CURLIB
VALIDATE Validate OnDemand disk storage *NO, *YES Optional
Top

Application group (APPGRP)

Specifies the name of the application group to perform management for.

Note: Position the cursor in the application group parameter entry and use the prompt (F4) key to view the list of application group values that are available for the default (*DFT) instance.

The default instance is specified in the QDFTINST data area. The QDFTINST data area can exist in multiple libraries. A search for the QDFTINST data area is performed using the library list. The first data area found will be used. If the QDFTINST data area is not found using the library list, the QUSRRDARS library will be searched for the data area. If the data area exists in the QUSRRDARS library it will be used. If the QDFTINST data area is not found, instance QUSROND is used.

*ALL
Management is done for all application groups.
application-group
Only perform management for the named application group.

If the value to be entered contains lower case letters, blanks, or special characters, it must be enclosed in apostrophes.

Top

Migration options (MGROPT)

Specifies what migration functions are to be performed.

*DATA
Migrate only OnDemand archived data.
*INDEXES
Migrate only OnDemand index data.

Note: Migrated indexes cannot be searched without first importing them back into OnDemand. Indexes that need to be searched should not be migrated. Before allowing indexes to be migrated, be sure that is really what you want to do.

*ALL
Migrate both OnDemand archived data and indexes.

Note: Migrated indexes cannot be searched without first importing them back into OnDemand. Indexes that need to be searched should not be migrated. Before allowing indexes to be migrated, be sure that is really what you want to do.

*NONE
No migrations are done.
Top

Expiration options (EXPOPT)

Specifies what expiration functions are to be performed.

*ALL
Perform all expiration options.
*DATA
Expire only OnDemand archived data.
*INDEXES
Expire only OnDemand index data.
*IMPIDX
Expire only imported index data.
*NONE
No expirations are done.
Top

Run ASM (STRASMOND)

Specifies whether to run the Archived Storage Management process after the Disk Storage Management process is finished.

*YES
Run the Archived Storage Management process.
*NO
Do not run the Archived Storage Management process.
Top

Policy (POLICY)

Specifies the name of the policy for Archived Storage Management to use when parameter STRASMOND is *YES.

Note: Position the cursor in the policy parameter entry and use the prompt (F4) key to view the list of policy values that are available for the default (*DFT) instance.

The default instance is specified in the QDFTINST data area. The QDFTINST data area can exist in multiple libraries. A search for the QDFTINST data area is performed using the library list. The first data area found will be used. If the QDFTINST data area is not found using the library list, the QUSRRDARS library will be searched for the data area. If the data area exists in the QUSRRDARS library it will be used. If the QDFTINST data area is not found, instance QUSROND is used.

*ALL
All policies are used. This causes all eligible data to be managed.
policy-name
Specify the name of the policy that ASM is to process. This causes only the eligible data associated with the named policy to be managed.

Note: Position the cursor in the policy parameter entry and use the prompt (F4) key to view the list of policy values that are available for the default (*DFT) instance.

The default instance is specified in the QDFTINST data area. The QDFTINST data area can exist in multiple libraries. A search for the QDFTINST data area is performed using the library list. The first data area found will be used. If the QDFTINST data area is not found using the library list, the QUSRRDARS library will be searched for the data area. If the data area exists in the QUSRRDARS library it will be used. If the QDFTINST data area is not found, instance QUSROND is used.

Top

Instance (INSTANCE)

Specifies the name of the OnDemand instance to use.

*DFT
The default OnDemand instance is used. The default instance is specified in the QDFTINST data area. The QDFTINST data area can exist in multiple libraries. A search for the QDFTINST data area is performed using the library list. The first data area found will be used. If the QDFTINST data area is not found using the library list, the QUSRRDARS library will be searched for the data area. If the data area exists in the QUSRRDARS library it will be used. If the QDFTINST data area is not found, instance QUSROND is used.
instance-name
Specify the name of the instance that is to be used. By definition, the instance must be on the system where the command is run.
Top

Start instance server (STRSVR)

Specify to start the instance server if it is not currently active.

*NO
The instance server for this instance will not be started.
*YES
The instance server for this instance will be started.
Top

Submit to batch (SBMJOB)

Specifies if DSM should run in batch or interactively.

*YES
This command should be submitted to run in a different job.
*NO
This command should be run within the current job. If you are entering this command from a terminal, this will prevent you from doing any other work from this terminal session until this command completes.
Top

Job description (JOBD)

Specifies the name of the job description used for the submitted job.

Qualifier 1: Job description

QOND400
The QOND400 job description is used as the job description for the submitted job.
jobd-name
Specify the name of the job description used for the job.

Qualifier 2: Library

QRDARS
Library QRDARS is used as the job description's library.
*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the job description name. If no library is specified as the current library for the job, QGPL is used.
library-name
Specify the name of the library where the job description name is located.
Top

Validate OnDemand disk storage (VALIDATE)

Specifies if OnDemand should validate its disk storage structures.

*NO
Do not validate the OnDemand disk structures.
*YES
All disk storage files are inspected to ensure that they are correctly linked with the proper file permissions.
Top

Examples

Example 1: Simple Example

STRDSMOND

This command submits a job to batch that starts the OnDemand Common Server Disk Storage Management (DSM) task which manages the movement of OnDemand data on disk and between disk and the Archived Storage Manager (ASM). When issued with no parameters specified, this command processes data for ALL defined application groups in the default instance named QUSROND, migrating data and expiring both data and indexes. Additionally, with no parameters specified as in this example, it will automatically run ASM after the DSM processing finishes.

Example 2: More Complex Example

STRDSMOND APPGRP(CHECKSTMTS) INSTANCE(ACCTING)

This command is similar to Example 1 but the Disk Storage Management process is run only for the Common Server application group called CHECKSTMTS within the ACCTING instance.

Top

Error messages

*ESCAPE Messages

CPF1338
Errors occurred on SBMJOB command.
OND0271
STRDSMOND ended in error.
Top