OpenTP1 Version 7 System Definition

[Contents][Index][Back][Next]

scdsvcdef (Specify the schedule service operation on a service basis)

Format

[scdsvcdef [-c service-name]
            [-p number-of-services-that-can-be-executed-concurrently]
            [-n number-of-service-requests-that-can-be-queued]
            [-l length-of-the-buffer-pool-storing-messages-that-can-be-queued]]

Function

The operation performed when an SPP places a service request in the schedule queue or removes a service request from the schedule queue can be specified on a service basis.

This specification is unnecessary for SUPs, MHPs, and socket receiving servers that are an SPP, and is ignored if specified for such programs.

Options

-c service-name ~<1-to-31-character identifier>

Specify the name of a specific service for which you want to specify the operation.

You can specify only a service name specified in the service operand of the user service definition. If you specify a service name that has not been specified in the service operand, OpenTP1 does not perform schedule control on a service basis.

If this option is omitted, the specified operation applies to all services. If this option is specified when a service name has also been specified in a definition operand, the definition operand takes precedence. If multiple instances of this operand have been specified, the last one specified takes precedence.

-p number-of-services-that-can-be-executed-concurrently ~<unsigned integer> <<1-1024>>

Specify the maximum number of service instances that can be executed concurrently for a service request for the service specified in the -c option.

This option takes effect when the specified value is smaller than the maximum number of SPP processes (specified by the parallel_count operand in the user service definition or by the scdchprc definition command). If this option is omitted, the number of services that can be executed concurrently is not checked.

-n number-of-service-requests-that-can-be-queued ~<unsigned integer> <<1-65535>>

Specify the maximum number of service requests that can be placed in the schedule queue for the requests for the service specified in the -c option.

This option takes effect when the specified value is smaller than the number of service requests that can be queued in the message storage buffer pool for SPPs. If this option is omitted, the number of service requests that can be queued is not checked.

-l length-of-the-buffer-pool-storing-messages-that-can-be-queued ~<unsigned integer> ((512-31457280)) (units: bytes)

Specify the length of the buffer pool for storing messages that can be placed in the schedule queue for requesting the service specified in the -c option.

This option takes effect when the specified value is smaller than the length of the message storage buffer pool for SPPs (specified by the message_store_buflen operand in the user service definition or by the scdbufgrp definition command). If this option is omitted, the length of the buffer pool storing messages that can be queued is not checked.

Note

Depending on the value specified in the -n or -l option, an attempt to place a service request in the schedule queue might fail. If the attempt fails, OpenTP1 outputs the KFCA00831-W error message, and attempts to re-assign the service request to another TP1 node. If there are no TP1 nodes to which the service request can be re-assigned, DCRPCER_NO_BUFS(-304) is returned to the RPC caller.