OpenTP1 Version 7 System Definition

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

mcftalcle (Definition of a logical terminal for starting applications)

Format

{{mcftalcle -l logical-terminal-name
            -t send|request
           [-m "[mmsgcnt=maximum-memory-storable-output-message-
                         count]
                [dmsgcnt=maximum-disk-storable-output-message-
                         count]"]
           [-k "[quekind=memory|disk]
                [quegrpid=queue-group-ID]"]}}

Function

This command defines the environment of the logical terminals for starting applications.

Logical terminals for an MHP (an error event processing) or for requests of a roll back of retry instructions, are generated automatically by MCF and need not be defined here. One or more logical terminals must be defined if using the application startup function.

Options

-l logical-terminal-name~<1-8 character identifier>

Specify the name of the logical terminal.

Make sure that the logical terminal name you specify is unique within the OpenTP1 system.

-t send|request

Specify the type of the logical terminal.

send
Send-type logical terminal. Use this terminal type to start an application for which noans is specified in the -n type operand of the mcfaalcap command.

request
Inquire-type logical terminal. Use this terminal type to start an application for which ans is specified in the -n type operand of the mcfaalcap command.

-m

(Operands)

mmsgcnt=maximum-memory-storable-output-message-count~<unsigned integer> ((0-65535)) <<0>>
Specify the maximum number of output messages which can be stored in memory. An error will be returned for any SEND requests from an UAP in excess of this number. If 0 is specified or if specification of this operand is omitted, the number of output messages to wait in memory will be the maximum value (65535).

dmsgcnt=maximum-disk-storable-output-message-count~<unsigned integer> ((0-65535)) <<0>>
Specify the maximum number of output messages which can be stored on disk. An error will be returned for any SEND requests from an UAP in excess of this number. If 0 is specified or if specification of this operand is omitted, the number of output messages to wait on disk will be the maximum value (65535).

-k

(Operands)

quekind=memory|disk~<<memory>>
Specify the allocation destination (memory queue or disk queue) for the output messages.
memory
Messages are allocated to the memory queue only.
disk
Messages are allocated to the disk queue and memory queue.
The quegrpid operand must be specified also if specifying disk.

quegrpid=queue-group-ID~<1-8 character identifier>
Specify the ID of the queue group used for the output messages stored on disk. Specify one of the queue group IDs (queue group type is otq) specified with the mcfmqgid command of the MCF manager definition.
This operand is valid only if disk is specified with the quekind operand.