Previous Topic: DCMT VARY TASK SyntaxNext Topic: DCMT VARY TASK Usage


DCMT VARY TASK Parameters

broadcast-parms

Indicates to execute the DCMT command on all or a list of data sharing group members.

Note: For more information about broadcasting and broadcast-parms syntax, see the section How to Broadcast System Tasks.

task-code

Specifies the task to vary.

ENable

Enables the task. A task is initially enabled at system generation time by the ENABLE parameter of the TASK statement.

DIsable

Disables the task. Disabling a task prevents it from being invoked until it is enabled. A task is initially disabled at system generation time by the DISABLE parameter of the TASK statement.

PRIority

Varies the dispatching priority of the specified task.

The dispatching priority is initially established at system generation time by the PRIORITY parameter of the TASK statement.

task-priority

An integer in the range 0 (lowest priority) to 255 (highest priority).

The limit for user tasks is 240.

PROgram

Varies the program initially invoked by the specified task.

The program is initially established at system generation time by the INVOKES parameter of the TASK statement.

dictnode

Specifies the DDS node that controls the data dictionary in which the named program resides.

dictname

Specifies the alternate data dictionary in which the named program resides.

Note: Although dictnode and dictname are both optional parameters, if dictnode is specified and dictname is not specified, a "." delimiter must be included to represent the missing dictname parameter. For example:

PRO dictnode..program-name V version-number

program-name

The name of a program load module.

version-number

The version number of the specified DC/UCF program.

The default is 1.

STAll

Varies the inactive wait interval for the task.

The inactive wait interval is initially established for a task at system generation time by the INACTIVE INTERVAL parameter of the TASK statement.

inactive-wait-time

The new inactive wait interval, in real-time seconds.

An integer in the range 1 through 32767.

SYStem

Varies the inactive wait time to the value established at system generation time by the INACTIVE INTERVAL parameter of the SYSTEM statement.

OFF

Specifies that DC/UCF does not terminate the task based on an inactive interval.

SAVe

Instructs DC/UCF to save the current terminal-screen contents associated with a task before writing the data stream associated with an immediate-write request.

The save status for a task is initially established at system generation time by the SAVE parameter of the TASK statement.

NOSave

Instructs DC/UCF not to save the current terminal-screen contents associated with a task before writing the data stream associated with an immediate-write request.

This save status for a task is initially established at system generation time by the NOSAVE parameter of the TASK statement.

RESource INTerval

Varies the resource timeout interval for the specified task.

The resource timeout interval is the amount of time after a pseudo-conversational task terminates that the logical terminal task is allowed to retain resources acquired by the task. When the resource interval is reached, DC/UCF invokes the resource timeout program.

resource-timeout-interval

The new resource timeout interval, in the range 0 through 32,767, measured in real-time seconds.

SYStem

Varies the resource timeout interval for the specified task to the value established at system generation time by the RESOURCE TIMEOUT INTERVAL parameter of the SYSTEM or TASK statement.

Information specified at the TASK level overrides information specified at the system level.

OFF

Instructs DC/UCF not to delete resources for the task based on a timeout interval.

RESource PRogram

Specifies the name of the program DC/UCF is to invoke when the resource timeout interval expires.

The resource timeout program processes (for example, deletes) resources held by the logical terminal on which the task executed.

program-name

The name of a program included in the system definition.

version-number

The version number of the program; an integer in the range 1 through 9,999.

The default is 1.

SYStem

Varies the resource timeout program to the program specified at system generation time on the RESOURCE TIMEOUT parameter of the SYSTEM or TASK statement.

Information specified at the task level overrides information specified at the system level.

LOCation BELow

Specifies that programs that run under the task must reside below 16 megabytes and must use 24-bit addressing.

The location of a task is initially established at system generation time by the LOCATION parameter of the TASK statement.

LOCation ANY

Specifies that programs that run under the task can reside anywhere in the DC/UCF region and can use either 24-bit or XA 31-bit addressing.

MAXimum CONcurrent

Varies the maximum number of concurrently active threads allowed for the specified task.

The maximum number of concurrently active threads allowed for a task is initially established at system generation time by the MAXIMUM CONCURRENT THREADS parameter of the TASK statement.

thread-count

An integer in the range 1 through 32,767.

OFF

Specifies that DC/UCF does not limit the number of concurrently active threads for the task.

STOrage

Varies the storage limit for the task, as described in Usage.

LOCK

Varies the lock limit for the task, as described in Usage.

CALl

Varies the call limit for the task, as described in Usage.

DBIo

Varies the database I/O limit for the task, as described in Usage.

limit-number

The new storage, lock, call, or database I/O limit for the task. The table located in Usage provides valid resource limits for each type of task thread.

Resource limits for a task are initially established at system generation time by the LIMIT parameter of the SYSTEM or TASK statement.

SYStem

Varies the storage, lock, call, or database I/O limit for the task to the value established at system generation time by the LIMIT FOR ONLINE TASKS parameter of the SYSTEM statement.

OFF

Disables limits. When OFF is specified for a resource, DC/UCF does not limit the task's use of the resource.

EXTernal WAIt

Varies the external wait setting for a task.

external-wait-time

The new external wait time in seconds. The value must be in the range 0 through 32,767. A value of 0 is equivalent to specifying SYSTEM.

SYStem

Indicates that the external wait time for a task is to be set to the value established for the system.

OFF

Indicates that there is no limit to the length of time that the system waits for an external user session to issue a database request.

QUIesce WAIt

Varies the quiesce wait time for a task.

quiesce-wait-time

Specifies the new quiesce wait time in wall clock seconds. The value must be in the range 0 through 32,767. A value of 0 is equivalent to specifying SYSTEM

SYStem

Specifies that the quiesce wait time for the task is determined by the quiesce wait setting in effect for the system.

OFF

Specifies that the task is not to be terminated due to a quiesce wait.

NOWait

Specifies that the task is not to wait for a quiesce operation to terminate. Instead an error is returned to the application program indicating that an area is unavailable. For navigational DML applications, this results in an error status of 'xx66'.

ON COMmit

Specifies options that control commit behavior. These options apply only to commit operations in which the database session remains active.

SYStem

Specifies that the commit behavior for the task should default to that specified for the system.

WRIte COMT

Specifies that a COMT journal record should be written.

WRIte ENDJ

Specifies that an ENDJ journal record should be written.

NEW ID Specifies that a new local transaction ID should be assigned to the next transaction started by the database session.

RETain ID Specifies that the current local transaction ID should be assigned to the next transaction started by the database session.

ON ROLlback

Specifies options that control rollback behavior. These options apply only to rollback operations in which the database session remains active.

SYStem

Specifies that the rollback behavior for the task should default to that specified for the system.

RETain ID

Specifies that the current local transaction ID should be assigned to the next transaction started by the database session.

NEW ID

Specifies that a new local transaction ID should be assigned to the next transaction started by the database session.

SNAp snap-options

Specifies the type of snap dump or photo snap to write to the DC/UCF log file.

Valid values are the following:

SYSTEM

Specifies whether to write a system snap dump for the specified task. A system snap dump writes a formatted display of the resources allocated to all active tasks.

ON Enables the writing of a system snap dump.

OFF Disables the writing of a system snap dump.

SYSTEM PHOTO

Specifies whether to write a system photo snap for the specified task. A system photo snap provides a summary of resources for all active tasks.

ON Enables the writing of a system photo snap.

OFF Disables the writing of a system photo snap.

TASK

Specifies whether to write a task snap dump for the specified task. A task snap dump writes a formatted display of the resources allocated to the task being snapped.

ON Enables the writing of a task snap dump.

OFF Disables the writing of a task snap dump.

TASK PHOTO

Specifies whether to write a task photo snap for the specified task. A task photo snap provides a summary of the resources for the task being snapped.

ON Enables the writing of a task photo snap.

OFF Disables the writing of a task photo snap.

LIMIT nnn

Specifies the total snaps allowed for the specified task. When the snap limit is reached, snaps are disabled for the task. The maximum snap limit value is 999.

TRAnsaction SHaring

Specifies the setting for the transaction sharing option.

ON

Specifies that transaction sharing should be initially enabled for any task of this type.

OFF

Specifies that transaction sharing should be initially disabled for any task of this type.

SYStem

Specifies that the transaction sharing option for a task of this type is based on the system default established in the sysgen or by a DCMT VARY TRANSACTION SHARING command.

More Information