Vous êtes sur la page 1sur 15

Man-Machine Language, Commands, Execute

MANUAL PAGE

Page 1 of 15

1/190 80-CNZ 218 1104 E

mml(1M)
Man-Machine Language, Commands, Execute
Contents
1

Format

2
2.1
2.2

Parameters
Options
Operands

Function

4
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9
4.10
4.11
4.12
4.13
4.14

Examples
Example: 1
Example: 2
Example: 3
Example: 4
Example: 5
Example: 6
Example: 7
Example: 8
Example: 9
Example: 10
Example: 11
Example: 12
Example: 13
Example: 14

5
5.1

Printouts
Diagnostics

Files

Command Owner

Glossary

9
9.1
9.2

Reference List
Application Information
Manual Pages

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 2 of 15

1 Format
mml [ -ac] [ -s -Q] [ -d device] [ -i device -I device] [ - y lines]
mml [ -s] [ -d device] [ - i device -I device] [ -r time] [ -w time] command ...
mml [ -bcs] [ -l line] [ -r time] [ -w time] - f file

2 Parameters
2.1 Options
-a
Receive spontaneous printouts
This option specifies that spontaneous printouts, for example alarm printouts, are received.
If the option is not specified, only answer printouts and result printouts of the ManMachine Language (MML) commands are received.
-b
Break inhibit
This option specifies that the operator wants to continue the execution of an MML
command file, even though that MML command is not successfully executed. If the option
is not specified, the execution of the MML command file stops in event of an error.
-c
Confirm automatically
This option specifies automatic confirmation of the command. This option is included as
default when an MML command is specified as an operand. If MML commands are executed
from a file and output is redirected to an output file, this option must be specified since
there is no way to confirm the commands manually.
-d device
Requested Input/Output (IO) device
This option specifies the IO device to be used.
Expressed as AD-n where:
n
Device number
Signed integer 0 - 1023
-f file
MML command file
This option specifies that MML commands contained in a text file are executed.
Text string
-i device
Copy printouts

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 3 of 15

This option specifies that result printouts of the MML commands and spontaneous printouts
are copied to the specified IO device. Answer, procedure and check printouts are not
affected.
Expressed as AD-n where:
n
Device number
Signed integer 0 - 1023
-I device
Redirect printouts
This option specifies that result printouts of the MML commands and spontaneous printouts
are redirected to the specified IO device. Answer, procedure and check printouts are not
affected.
Expressed as AD-n where:
n
Device number
Signed integer 0 - 1023
-l
Start Line
This option specifies the line number, in the MML command file, from where execution
starts.
If this option is omitted the execution starts from the first line in the MML command file.
Signed integer 1 - 2 147 483 647
-Q
Select Central Processor (CP) side
This option enables the command to be included in the login configuration file. After a
successful logon,the following question appears:
Connect to CP-EX? yes/[no]:
yes, establishes a connection to the Executive (EX) side of the CP.
no, establishes a connection to the separated Standby (SB) side. The default answer is
yes.
-r time
Retry time
This option specifies the time period an MML command is retried, if the command returned
FUNCTION BUSY. The MML command is sent for execution repeatedly until the retry time
has elapsed or the MML command is accepted. If the option is not specified, the MML
command is not retried. The retry time is specified in minutes.
Signed integer 0 - 1440
-s

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 4 of 15

Connect to separated CP side


This option specifies that the MML command is directed to the separated CP-SB side. If an
MML session is activated, this session is established towards the separated CP-SB side. If
the option is not specified, the MML command is directed to the CP-EX side.
-w time
Wait time
This option specifies a time limit for waiting for result printouts of the MML commands. If
the wait time is specified to zero (0), the command does not wait for the result printouts.
If the option is not specified, the command waits until the result printouts are received.
The waiting time is specified in minutes.
Signed integer 0 - 1440
-y lines
Lines per page
This option specifies number of lines per page. Each page starts with an exchange header.
If this option is omitted the page is continuous.
Signed Integer 10 - 1000
2.1.1

Operands

command...
MML command
This operand is a valid MML command string. The operand is repeatable.

3 Function
This command is used to execute MML commands. The mml command has three different
formats: MML session, MML command, and MML command file.
Format 1, MML Session
When mml is entered without the file option, or without the command operand, an MML session
is activated. Procedure, answer and check printouts are received immediately in response to
MML commands. Result and spontaneous printouts are received when CTRL-D (<EOT>) is
pressed. If CTRL-D (<EOT>) is pressed during a printout, the printout is interrupted. The prompt
is received when CTRL-M (<ENTER>) is pressed. From an MML session it is possible to switch to
Adjunct Processor (AP) local mode, by using command APLOC. To return from AP local mode to
the MML session, use Shell built-in command to exit, for example exit . To end the MML session,
use command EXIT.
Note:
To receive spontaneous printouts, for example alarm printouts, option -a must be
specified.
To preserve lower case letters, the string containing the lower case letters must be surrounded
by quotationmarks (") and dollar-signs ($). Example: "$lowercase$". The character to indicate
the lower case string (together with the qoutationmark) is defined as a parameter, with the
dollar-sign as the default value.
Format 2, MML Command
This format enables use of MML commands in Shell scripts, or MML commands from the Shell
prompt. The MML command is automatically confirmed.

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 5 of 15

It is possible to specify more than one MML command as operands; individual MML commands
must be separated by a space character. If a separate operand (MML command) includes
command parameters, which include the space character, the whole operand must be
surrounded by quotation marks (").
If an ampersand (&) is included in the command, the command must be surrounded by
quotation marks (").
To preserve lower case letters, the string containing the lower case letters must be surrounded
by apostrophes (') and dollar-signs ($). Example: '$lowercase$'. The character to indicate the
lower case string (together with the apostrophes) is defined as a parameter, with the dollar-sign
as the default value.
Format 3, MML Command File
Option -f is used to execute a text file containing MML commands. The option argument file
indicates the name of the text file. If an error occurs and option -b is omitted, the execution of
MML commands is stopped.
By using option -l, the execution of the command file starts at the specified line.
Note:
If option -c is specified, the MML commands are automatically confirmed.
Note:
If option -c is omitted and output is redirected to an output file, the execution of the
command file will be hanging if any command requires confirmation.

4 Examples
4.1 Example: 1
This is an example of the MML session format. The MML session is activated with command mml.
When the CP prompt is received, command DPWSP is executed, and the answer printout is
displayed. The MML session is closed by using command EXIT.
prompt> mml
WO
INGO1/I19/CNM204/APM
<DPWSP;
CP STATE
MAU
NRM
END

SB
B

AD-37

TIME 010119 1041

PAGE

SBSTATE
WO

<EXIT;
prompt>

4.2 Example: 2
This is an example of the MML session format. The MML session is activated with command mml
and option -a, in order to receive spontaneous printouts. The first command that is executed is
IOSTP. When the answer printout is received from command IOSTP, command SYCLI is
executed. The answer printout from command SYCLI is received. When CTRL-D (<EOT>) is
pressed, the result printout and the spontaneous printout are received. When CTRL-M

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 6 of 15

(<ENTER>) is pressed, the CP prompt is received. The MML session is closed by using command
EXIT.
prompt> mml -a
WO
INGO1/I19/CNM204/APM
<IOSTP;
IO DEVICE STATUS
IOIND
H'D400
H'C001

STATE
READCOM
USERCON

SUBSTATE
IDLE
WRITES

AD-28

COMMAND
IOSTP

USERB
ADE
SEC12

TIME 010119 1025

USERP
0
9

PAGE

USERO FO DEVICE
13 Y AD-22(17194)
2 Y AD-28(17631)

DEVICE SEIZURE STATUS


SIZIND
NONE

USERB

PRCA

STATUS

RESPTIME

DEVICE

TYPE

END

<SYCLI;
SYCLI;
<;
ORDERED
< <CTRL-D>
WO
INGO1/I19/CNM204/APM
COMMAND LOG ACTIVATION RESULT

AD-28

TIME 010119 1029

PAGE

WO
INGO1/I19/CNM204/APM
AD-28
TIME 010119 1029 PAGE
*** ALARM CEASING 003 A2/APZ "INGO1/I19/CNM20"U 010119 1029
COMMAND LOG BLOCKED

RESULT
ACTIVATED
END

FAULT
FAULT CODE 155
COMMAND LOG NOT ACTIVATED
END
<CTRL-M>
WO
INGO1/I19/CNM204/APM
<EXIT;
prompt>

AD-28

TIME 010119 1029

PAGE

4.3 Example: 3
This is an example of the MML session format. The MML session is activated with command mml,
and command IOIOP is executed. AP local mode is entered by using command APLOC. In AP
local mode, command cpdlist(1M) is executed. A return to CP mode is performed with command

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 7 of 15

exit . Next, command IOROP is executed. Finally, the MML session is closed by using command
EXIT.
prompt> mml
WO
INGO1/I19/CNM204/APM
<IOIOP:IO1=ALL;
IO DEVICE DATA
ALPHANUMERIC DEVICES
IO
RP
EM DVPMR
AD-1
AD-2
AD-0
AD-100

STANDBY

AD-32

DET

TIME 010119 1033

LINE
50
50

COMMATT
COMMATT
COMMATT
COMMATT
COMMATT

ATT

PAGE

STATE
BLOCK

END
<APLOC;
Microsoft(R) Windows NT(TM)
(C) Copyright 1985-1996 Microsoft Corp.
prompt>
DEVICE
AD-0
AD-100

cpdlist
SEP TYPE
No File
No File

TIME LINES FF
0
- 0
- -

EOL EOP
none none
none none

PRCA
-

PARAMETER
-f .
-f .

prompt> exit
WO
INGO1/I19/CNM204/APM
<IOROP;
IO PRINTOUT ROUTING DATA
PRCA
0&&34
35
36&&127
128&&255

IO
AD-0
AD-100
AD-0

DTYPE
FIRST
FIRST
FIRST

AD-32

CLASSA
0&1&2&3&4&5
0&1&2&3&4&5
0&1&2&3&4&5

TIME 010119 1033

CLASSUA
0&1&2&3&4&5
0&1&2&3&4&5
0&1&2&3&4&5

COND
2
2
2

PAGE

SYSDEV
YES
YES
YES

END
<EXIT;
prompt>

4.4 Example: 4
This is an example of the MML session format. The MML session is activated, with command mml
and option -y, to set the number of lines per page. The exchange header is printed every 10:th
line. When CTRL-D (<EOT>) is pressed the result printout from command SYCLI is received. The
printing of exchange headers restarts for every received result printout. When CTRL-M
(<ENTER>) is pressed, the CP prompt is received and the printing of exchange headers restarts.
prompt> mml -y 10
WO
INGO1/I19/CNM204/APM
<iostp;
IO DEVICE STATUS
IOIND

STATE

SUBSTATE

COMMAND

AD-543

USERB

TIME 010117 1027

USERP

PAGE

USERO FO DEVICE

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

H'7C00

USERCON

WRITES

IOSTP

SEC 12

Page 8 of 15

2 Y

AD-548(17273)

DEVICE SEIZURE STATUS


WO
SIZIND
NONE

INGO1/I19/CNM204/APM
USERB
PRCA STATUS

AD-543
RESPTIME

TIME 010117 1027 PAGE


DEVICE
TYPE

END
<iostp;
IO DEVICE STATUS

WO
IOIND
H'7C00

INGO1/I19/CNM204/APM
AD-543 TIME 010117 1028 PAGE
3
STATE
SUBSTATE COMMAND USERB
USERP USERO FO DEVICE
USERCON WRITES
IOSTP
SEC 12
9
2 Y AD-548(17273)

DEVICE SEIZURE STATUS


SIZIND
NONE

USERB

PRCA

STATUS

WO
END

INGO1/I19/CNM204/APM

RESPTIME

DEVICE

TYPE

AD-543

TIME 010117 1028

PAGE

AD-543

TIME 010117 1029

PAGE

AD-543

TIME 010117 1029

PAGE

<sycli;
SYCLI;
<;
ORDERED
< <CTRL-D>
WO
INGO1/I19/CNM204/APM
COMMAND LOG ACTIVATION RESULT
RESULT
FAULT CODE 45
DEVICE FAULT
END
<CTRL-M>
WO
INGO1/I19/CNM204/APM
<exit;
prompt>

4.5 Example: 5
This is an example of how to preserve lower case letters in an MML session.
prompt> mml
WO
INGO1/I19/CNM204/APM
AD-36
<IOCDI:APPL=TEST,STR="$Lower case$";

TIME 010119 1039

PAGE

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 9 of 15

IOCDI:APPL=TEST,STR="Lower case";
<;
EXECUTED
<IOCDP;
IO CONFIGURATION DATA
APPL
TEST
CPF
MML01

NUM

STR
Lower case

END
<IOCDE:APPL=TEST;
IOCDE:APPL=TEST;
<;
EXECUTED
<EXIT;
prompt>

4.6 Example: 6
This is an example of how to redirect all received result and spontaneous printouts to another
MML session, in this case AD-10. Option -c is used to confirm the commands automatically.
Start the MML session that shall receive the redirected printouts, and use option -d to connect it
to AD-10.
prompt> mml -d AD-10
WO
BIO 8.1 R312/00/04 W749
<<CTRL-D>

AD-10

TIME 000626 1809

PAGE

Start the MML session that shall be used for executing the MML commands. Specify AD-10 to
option -I to redirect the printouts.
prompt> mml -I AD-10 -c
WO
BIO 8.1 R312/00/04 W749
<DPWSP;
CP STATE
MAU
NRM

SB
B

AD-20

TIME 000626 1810

PAGE

SBSTATE
WO

END
<SYCLI;
ORDERED
<LABUP;
ORDERED
<EXIT;
prompt>

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 10 of 15

The result printouts from commands SYCLI and LABUP are received on the previously started
MML session ( AD-10). Note that no result or spontaneous printouts are received on the MML
session connected to AD-20. It is possible to receive result and spontaneous printouts on AD-20
and at the same time direct a copy of the printout to AD-10 by using option -i.
The following printouts are received on the MML session that is connected to AD-10.
WO
BIO 8.1 R312/00/04 W749
COMMAND LOG ACTIVATION RESULT

AD-20

TIME 000626 1810

PAGE

AD-20

TIME 000626 1812

PAGE

RESULT
FAULT CODE 93
NO SUBFILE DEFINED
END
WO
BIO 8.1 R312/00/04 W749
STORAGE BANK STATISTICS
BANKTYPE
32
64
128
256
512
1K
2K
4K
8K
16K
32K
END

SIZE
1100
2000
1100
50
250
1100
600
200
200
100
100

NIU
28
16
35
2
1
4
2
0
0
0
0

MNIU
30
19
37
10
2
6
3
0
0
0
0

NCONG
0
0
0
0
0
0
0
0
0
0
0

4.7 Example: 7
This is an example of the MML command format. A single command, DPWSP, is executed from
the Shell prompt.
prompt> mml DPWSP
CP STATE
MAU
NRM

SB
B

SBSTATE
WO

END
prompt>

4.8 Example: 8
This is an example of the MML command format. Command SYCLI is executed from the shell
prompt. Note that the MML command is automatically confirmed.
prompt> mml SYCLI
ORDERED
COMMAND LOG ACTIVATION RESULT

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 11 of 15

RESULT
ACTIVATED
END
prompt>

4.9 Example: 9
This is an example of the MML command format. Commands IOROP and SYCLI are executed
from the Shell prompt. Note that the MML command is automatically confirmed.
prompt> mml IOROP SYCLI
IOROP; IO PRINTOUT ROUTING DATA

PRCA

IO

DTYPE

CLASSA

CLASSUA

CON

4.10 Example: 10
This is an example of the MML command file format. The text file, cmd.file, contains commands
DPWSP and LASIP. Note that the command file contains the MML commands only. Specify the
command file with option -f.
prompt> type cmd.file
DPWSP; LASIP:BLOCK=AOT;
prompt> mml -f cmd.file
DPWSP; CP STATE

MAU

SB

SBSTATE NRM

WO

END

LASIP:BLOCK=AOT; SOFTWARE UNIT IDENT

Note that neither of these MML commands required a confirmation order to execute.

4.11 Example: 11
This is an example of the MML command format. The command includes an ampersand (&).
Therefore it must be surrounded by quotation marks (").
prompt> mml "IOROI:PRCA=0&&31"

4.12 Example: 12
This is an example of the MML command format. To preserve lower-case letters the string,
containing the lower-case letters, is surrounded by apostrophes (') and dollar-signs ($). The
command also includes a space in the string, therefore the command must be surrounded by
quotationmarks (").
prompt> mml "IOCDI:APPL=TEST,STR='$Lower Case$'"
EXECUTED
prompt> mml IOCDP
IO CONFIGURATION DATA

APPL

NUM

STR TEST

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

Lower Case CPF

2/6/2016

Man-Machine Language, Commands, Execute

Page 12 of 15

4.13 Example: 13
This is an example of the MML command file format. The text file, command.file, contains
commands SYCLI and IOROP.
prompt> type command.file
SYCLI; IOROP;
prompt> mml -f command.file
sycli; <; ORDERED COMMAND LOG ACTIVATION RESULT

RESULT ACTIVATED

END

iorop; IO PRINTO

Note that the command SYCLI requires manual confirmation.

4.14 Example: 14
This is an example of the MML command file format with redirected output. The text file,
command.file, contains commands SYCLI and IOROP. The output is redirected to the file
output.txt using the operator >.
prompt> type command.file
SYCLI; IOROP;
prompt> mml -cf command.file > output.txtprompt> type output.txt
sycli; ORDERED COMMAND LOG ACTIVATION RESULT

RESULT ACTIVATED

END

iorop; IO PRINTOUT R

Note that, if option -c is missing the confirmation prompt for command SYCLI; is redirected to
the output file, making the command hang, waiting for confirmation. When redirected output is
used together with command files, option -c must always be used.

5 Printouts
5.1 Diagnostics
Exit code: 0
Indicates a successfully executed command, and should return the user prompt.
Error when executing ( general fault )
Exit code: 1
An error was detected while the commad was executing.
Incorrect usage
Exit code: 2
The command was incorrectly specified.
Illegal option <option>
Exit code: 20
An illegal option was specified.

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 13 of 15

Illegal combination of options <option>


Exit code: 21
An illegal combination of options was specified.
Unreasonable value <value>
Exit code: 22
An argument was specified with an unreasonable value.
Authorization failure
Exit code: 24
The specified user does not have the authority to execute MML commands.
CP not obtainable
Exit code: 40
A connection to the CP could not be established. The reason could be either:
- CP is restarting or reloading, or
- Communication path between the CP and the AP is not working.
CP standby not obtainable
Exit code: 41
A connection to the CP-SB side could not be established. The reason could be either:
- CP is restarting or reloading, or
- Communication path between the CP and the AP is not working, or
- CP or the Regional Processor (RP) is not separated.
File does not exist
Exit code: 50
The specified file name does not exist.
Execution stopped at line <line>. Use option -l to restart file reading.
Exit code: 58
An error has occurred during execution of an MML command file.
Device is occupied
Exit code: 60
The specified device is already in use.
Only allowed from active AP node
Exit code: 83
Command mml can not be executed on the passive AP node.

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 14 of 15

MML SERVER NOT PROPERLY DEFINED


The MML server has not been properly installed. Refer to the Application Information (AI) for
block AD2 for details. Note that the MML session (with option -a) is not able to receive
spontaneous printouts when this printout is received.

6 Files
No file information is applicable to this command.

7 Command Owner
MLS

8 Glossary
AD
Alphanumeric Device
AP
Adjunct Processor
CP
Central Processor
EX
Executive
IO
Input/Output
MML
Man-Machine Language
MLS
Man-machine Language Services
RP
Regional Processor
SB
Standby

9 Reference List
9.1 Application Information
AD2

9.2 Manual Pages


cpdlist(1M)
IO Device in CP, Attributes, List

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Man-Machine Language, Commands, Execute

Page 15 of 15

exit(1)

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm

2/6/2016

Vous aimerez peut-être aussi