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


DCMT VARY DYNAMIC 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 How to Broadcast System Tasks.

Task

Dynamically defines (or deletes) a specified task.

task-code

The name of a task.

Rules for naming a task appear under Usage.

INVokes program

Specifies the program initially invoked by the named task code.

program-specification

The name of a program load module. The INVOKES PROGRAM clause is required for a task code that does not already exist. For a detailed description of the parameters see program-specification.

DELete

Deletes the definition of the named task code from the run-time system.

Only task codes defined dynamically can be deleted in this way.

ENAble

Enables the specified task.

ENABLE is the default.

DISable

Disables the specified task. Disabling a task prevents it from being invoked until it is enabled.

EXTernal

Specifies that the task can be invoked externally or internally.

EXTERNAL is the default.

A task is invoked externally when the user enters the task code in response to the ENTER NEXT TASK CODE prompt.

INTernal

Specifies that the task can be invoked internally only.

A task is invoked internally when an executing program specifies the task code in an ATTACH or DC RETURN NEXT TASK CODE request.

EXTernal WAIt

Establishes the external wait setting for a task.

external-wait-time

Specifies the 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

Specifies that the external wait time for the task is to be set the to value in effect for the system. If external wait is not specified, SYStem is the default.

OFF

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

INActive interval

Varies the inactive wait interval for the named task.

inactive-wait-time

The number of real-time seconds, in the range 1 through 32767, after which the system should terminate an inactive task.

SYStem

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

SYSTEM is the default.

OFF

Directs DC/UCF not to terminate the task based on an inactive interval.

INPut

Specifies that the terminal input buffer can contain data in addition to the task code.

NOInput

Specifies that the terminal input buffer can contain only the task code. NOINPUT is the default.

LOCation

Specifies the location where programs run under the specified task may reside.

ANY

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

ANY is the default.

BELow

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

MAP

Specifies that the task performs a mapout automatically when the task is invoked.

NOMap

Specifies the task does not perform a mapout automatically when the task is invoked.

NOMAP is the default.

MAXimum CONcurrent

Specifies the maximum number of concurrently active threads allowed for the specified task. Valid values are:

OFF

Directs DC/UCF not to limit the number of concurrently active threads for the task.

OFF is the default.

thread-count

A thread count in the range 1 through 32,767.

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.

PRINT key

Specifies the key to be used to print screen contents.

PFn Specifies a program function key.

Valid PF key values are PF1 through PF24.

PAn Specifies a program attention key.

Valid values are PA1 and PA2.

SYStem Specifies the key established at system generation by the PRINT KEY parameter of the SYSTEM statement.

SYSTEM is the default.

OFF Disables the print-screen facility for the task.

PRIority

Specifies the dispatching priority of the named task.

task-priority An integer in the range 0 (lowest priority) through 240 (highest priority).

The default is 100.

QUIesce WAIt

Establishes the quiesce wait time for a task. The quiesce wait interval determines the amount of time that the task waits on a quiesce operation before being canceled.

quiesce-wait-time Specifies the 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'.

RESource INTerval

Specifies the resource timeout interval for the named 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 A number of real-time seconds in the range 1 through 32,767.

SYStem Sets 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 statement.

SYSTEM is the default.

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

RESource PRogram

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

SYStem Specifies that the resource timeout program established by the RESOURCE TIMEOUT PROGRAM parameter of the system generation SYSTEM statement is to be invoked.

program-specification See program-specification for a detailed description of the parameters.

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.

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.

NOSave is the default.

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.

.

The space and the period together are required and signal the end of the statement.

program-specification

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 bothoptional parameters, if dictnode is specified and dictname is not specified, a "." delimiter must be included to represent the missing dictname parameter. For example:

RES PR dictnode..program-name V version-number

program-name

The name of a program included in the system definition.

Version version-number

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

The default is 1.

More Information