OpenTP1 Version 7 System Definition

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

4.2 Types of definitions

Organization of this section
(1) MCF manager definitions
(2) MCF communication configuration definitions
(3) MCF application definitions
(4) MCF performance verification trace definitions
(5) System service information definition
(6) System service common information definition

(1) MCF manager definitions

Table 4-5 shows the MCF manager definitions.

Table 4-5 MCF manager definitions

Type Command Option Operand Definition Specification
Command mcfmenv -m id MCF manager process identifier <alphabetical character> ((A-Z, a-z)) <<A>>
name MCF manager name <1-to-8-character identifier>
mcfmcomn -n Number of logical terminals using sequence numbers <unsigned integer> ((0-2048)) <<0>>
-p MCF work area size <unsigned integer> ((100-2000000)) (units: Kbytes)
-j Journal buffer size for MCF manager processes <unsigned integer> ((multiple of 4 within the 4096 to 4000000 range)) <<4096>> (units: bytes)
-o cmdsvname MCF online command service name <1-8 alphanumeric characters>
-r Number of simultaneous transaction processes of other nodes <unsigned integer> ((0-1310720))
-c Maximum number of concurrent synchronous sending processes <unsigned integer> ((1-10000)) <<255>>
-w stats Whether to acquire the MCF statistics yes | <<no>>
mcfmcname -s mcfsvname MCF communication service name <1-8 alphanumeric characters>
syssvname System service information definition file name <1-to-8-character identifier>
mcfmuap -d Maximum number of communication functions issued <unsigned integer> ((0-65535)) <<0>> (units: times)
-t sndtim Synchronous sending monitoring time <unsigned integer> ((0-65535)) <<0>> (units: seconds)
sndrcvtim Synchronous transmission monitoring time <unsigned integer> ((0-65535)) <<0>> (units: seconds)
recvtim Synchronous receiving monitoring time <unsigned integer> ((0-65535)) <<0>> (units: seconds)
-j Journal buffer size for user servers <unsigned integer> ((multiple of 4 within the 4096 to 4000000 range)) <<32768>> (units: bytes)
-e segsize Maximum segment size to start MHP for processing an error event, or to use the application startup facility <unsigned integer> ((512-2147483647)) <<512>> (units: bytes)
-l initseq Initial sequence number <unsigned integer> ((0-2147483647)) <<1>>
maxseq Maximum sequence number for wrap <unsigned integer> ((0-2147483647)) <<65535>>
minseq Starting sequence number after wrap <unsigned integer> ((0-1)) <<1>>
-u ntmetim Nontransaction MHP expiration time <unsigned integer> ((0-65535)) <<0>> (units: seconds)
-a delaytim Delaying time allowance of application startup <unsigned integer> ((0-360)) <<0>>
-c order Selecting the order for sending and resending messages and for starting applications <<function>> | commit
mcfmqgid -q quekind Specifies the type of the queue. itq | otq
quegrpid Queue group ID <1-to-8-character identifier>
mcfmexp -g Service group registration count <unsigned integer> ((total number of service groups up to 2147483647))
-l Logical-terminal registration count <unsigned integer> ((total number of logical terminal up to 2147483647))
-I Specifies whether to perform fall-back operation if the input disk queue is unavailable. dg | <<ndg>>
-o Specifies whether to perform fall-back operation if the output disk queue is unavailable. dg | <<ndg>>
mcfmsts -g Maximum service group count <unsigned integer> ((1-1044480))
-v Maximum service count <unsigned integer> ((1-1044480))
mcfmsmsg -m ID of the message you do not want to output to the log file <unsigned integer>
((10000-19999 and 28000-29999))
mcfmsvg -g servgrpn Service group name <1-to-31-character identifier>
-w watchcnt Number of messages remaining in the input queue being monitored <unsigned integer> ((0-65535)) <<0>>
watchint Interval at which the input queue is checked for remaining messages <unsigned integer> ((5-3600)) <<10>> (units: seconds)
expectcnt Number of service requests that an MHP is expected to process <unsigned integer> ((1-65535))
abort Whether the OpenTP1 system fails if the processing capacity of an MHP is insufficient yes | <<no>>

(2) MCF communication configuration definitions

Table 4-6 shows the MCF communication configuration definitions.

Table 4-6 MCF communication configuration definitions

Type Command Option Operand Definition Specification
Command mcftenv -s MCF communication process identifier or application startup process identifier <numeric character (0-9), a-f> ((01-ef))
-m MCF manager identifier <alphabetic character> ((A-Z, a-z)) <<A>>
-a MCF application definition object file name <1-to-8-character identifier>
-q diskitq Whether to use a disk queue as the input queue <<yes>> | no
mcftcomn -j Journal buffer size for MCF communication process or application startup process <unsigned integer> ((multiple of 4 within the 4096 to 4000000 range)) <<32768>> (units: bytes)
mcfttred -m Maximum processing multiplicity <unsigned integer> ((1-1000)) <<10>>
mcfttim -t btim Time check interval <unsigned integer> ((1-60)) <<1>> (units: seconds)
mtim Unprocessed send message remaining time <unsigned integer> ((60-65535)) <<180>> (units: seconds)
rmtim Unprocessed receive message remaining time <unsigned integer> ((0-65535)) <<0>> (units: seconds)
-p usertime Whether to use the facility for user timer monitoring yes | <<no>>
timereqno Maximum number of time-monitored requests <unsigned integer> ((1-10000)) <<16>>
msgsize Maximum message length <unsigned integer> ((0-256)) <<0>> (units: bytes)
msgout Whether to output messages yes | <<no>>
mcfttrc -t size MCF trace buffer size <unsigned integer> ((multiple of 4 within the 4096 to 15728640 range)) <<204800>> (units: bytes)
disk Specifies whether to use the MCF trace disk output facility. <<yes>> | no
bufcnt MCF trace buffer count <unsigned integer> ((10-2147483647)) <<100>>
trccnt MCF trace file count <unsigned integer> ((3-99)) <<3>>
msgsize Maximum size of a message that can be acquired as trace data <unsigned integer> ((0-1073741824)) <<128>>(units: bytes)
mcfttrc -m Specifies the action if the MCF trance file count is exceeded. <<del>> | off
mcftsts -a Maximum application count <unsigned integer> ((1-65535))
-l Maximum logical terminal count <unsigned integer> ((1-65535))
mcftbuf -g groupno Group number of buffers for message transmission or for message editing <unsigned integer> ((1-512))
length Length of buffers for message transmission or for message editing <unsigned integer> ((512-1073741824)) (units: bytes)
count Number of buffers for message transmission or for message editing <unsigned integer> ((1-65535))
extend Number of buffers to be extended <unsigned integer> ((0-65535)) <<0>>
mcftpsvr -c Internal communication path name <1-to-8-character identifier>
-o reruntm Specifies whether to inherit the timer start at rerun. yes | <<no>>
mcftalcle -l Logical terminal name <1-to-8-character identifier>
-t Specifies the terminal type of this logical terminal. send | request
-m mmsgcnt Maximum number of output messages that can be stored on memory <unsigned integer> ((0-65535)) <<0>>
dmsgcnt Maximum number of output messages that can be stored on disk <unsigned integer> ((0-65535)) <<0>>
-k quekind Specifies the type of medium for the output queue. <<memory>> | disk
quegrpid Queue group ID <1-to-8-character identifier>
mcftped End of application startup environment definition None

(3) MCF application definitions

Table 4-7 shows the MCF application definitions.

Table 4-7 MCF application definitions

Type Command Option Operand Definition Specification
Command mcfaenv -a MCF application definition identifier <1-to-8-character identifier>
-p Application startup process identifier <numeric character (0-9), a-f> ((01-ef))
mcfaalcap -n name Application name or MCF event name <1-to-8-character identifier>
kind Specifies the kind of the application. <<user>> | mcf
type Specifies the type of the application. ans | <<noans>> | cont
aplihold Specifies the application's action to be taken if the application abnormally terminates. <<m>> | a | s
msgcnt Maximum number of storable input messages <unsigned integer> ((0-65535)) <<0>>
lname Logical terminal name <1-to-8-character identifier>
cname Internal communication path name <1-to-8-character identifier>
tempsize Continuous inquiry-response temporary data storage area size <unsigned integer> ((1-32000)) <<4096>> (units: bytes)
trnmode Specifies the transaction attribute of the application. <<trn>> | nontrn
errevt Whether error events should be reported yes | <<no>>
-N modelname Specifies an application name or MCF event name Model application name | model MCF event name
-g servgrpn Service group name of this application <1-to-31-character identifier>
quegrpid Queue group ID <1-to-8-character identifier>
quekind Specifies the type of the medium for the input queue. <<memory>> | disk
type Specifies the type of UAP. <<MHP>> | SPP
srvghold group's action to be taken if the application terminates abnormally. <<m>> | s
recvmsg Specifies how to handle the receive message of the UAP that terminated abnormally. <<e>> | r
-v servname Service name for the additional application name <1-to-31-character identifier>
servhold Specifies how to handle the service if the application terminates abnormally. <<m>> | a | s
ntmetim Nontransaction MHP expiration time <unsigned integer> ((0-65535)) (units: seconds)
-d holdlimit Maximum application abnormal termination count <unsigned integer> ((0-65535)) <<1>> (units: times)
holdlmtyp Specifies how to count the application abnormal termination count. sum | <<cont>>
-j ij Specifies whether to collect the historical data when a message received from another system is recorded in the input queue. yes | <<no>>
oj Specifies whether to collect the historical data when a message send request is issued from UAP. yes | <<no>>
gj Specifies whether to collect the historical data when a message receive request is issued from UAP. yes | <<no>>
-e evtlogout Specifies whether to output log messages when starting ERREVT1 to ERREVT4. yes | <<no>>

(4) MCF performance verification trace definitions

Table 4-8 shows the MCF performance verification trace definitions.

Table 4-8 MCF performance verification trace definitions

Type Operand Definition Specification
set prf_file_size MCF performance verification trace information file size <unsigned integer>
((1024-1048576)) <<1024>>
(units: kilobytes)
prf_file_count Number of generations for the MCF performance verification trace information file <unsigned integer>
((3-256)) <<3>>

(5) System service information definition

Table 4-9 shows the system service information definition.

Table 4-9 System service information definition

Type Operand Definition Specification
set module Name of the MCF executable program that starts the MCF communication service <1-to-8-character identifier>
mcf_prf_trace Specifies whether to acquire MCF performance verification trace information for each MCF communication service. <<Y>> | N

(6) System service common information definition

Table 4-10 shows the system service common information definition.

Table 4-10 System service common information definition

Type Operand Definition Specification
set max_socket_descriptors Maximum number of file descriptors for sockets <unsigned integer> ((64-2047))
max_open_fds Maximum number of files to be accessed by the MCF communication process <unsigned integer> ((100-2016)) <<500>>
thdlock_sleep_time Thread's waiting time if a lock conflict occurs among threads <unsigned integer> ((1-32767)) <<15>> (unit: milliseconds)
mcf_prf_trace_level MCF performance verification trace information acquisition level ((00000000-00000001))
<<00000000>>