Man-Machine Language, Commands, Execute Page 1 of 15

MANUAL PAGE 1/190 80-CNZ 218 1104 E

mml(1M)

Man-Machine Language, Commands, Execute

Contents
1 Format

2 Parameters
2.1 Options
2.2 Operands

3 Function

4 Examples
4.1 Example: 1
4.2 Example: 2
4.3 Example: 3
4.4 Example: 4
4.5 Example: 5
4.6 Example: 6
4.7 Example: 7
4.8 Example: 8
4.9 Example: 9
4.10 Example: 10
4.11 Example: 11
4.12 Example: 12
4.13 Example: 13
4.14 Example: 14

5 Printouts
5.1 Diagnostics

6 Files

7 Command Owner

8 Glossary

9 Reference List
9.1 Application Information
9.2 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 Man-
Machine 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:

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:

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:

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 AD-37 TIME 010119 1041 PAGE 1

<DPWSP;
CP STATE

MAU SB SBSTATE
NRM B WO
END

<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 AD-28 TIME 010119 1025 PAGE 1

<IOSTP;
IO DEVICE STATUS

IOIND STATE SUBSTATE COMMAND USERB USERP USERO FO DEVICE

H'D400 READCOM IDLE ADE 0 13 Y AD-22(17194)
H'C001 USERCON WRITES IOSTP SEC12 9 2 Y AD-28(17631)

DEVICE SEIZURE STATUS

SIZIND USERB PRCA STATUS RESPTIME DEVICE TYPE

NONE

END

<SYCLI;
SYCLI;
<;
ORDERED

< <CTRL-D>

WO INGO1/I19/CNM204/APM AD-28 TIME 010119 1029 PAGE 1

COMMAND LOG ACTIVATION RESULT

RESULT
ACTIVATED

END

WO INGO1/I19/CNM204/APM AD-28 TIME 010119 1029 PAGE 1

*** ALARM CEASING 003 A2/APZ "INGO1/I19/CNM20"U 010119 1029
COMMAND LOG BLOCKED

FAULT
FAULT CODE 155
COMMAND LOG NOT ACTIVATED

END

<CTRL-M>
WO INGO1/I19/CNM204/APM AD-28 TIME 010119 1029 PAGE 1
<EXIT;
prompt>

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 AD-32 TIME 010119 1033 PAGE 1

<IOIOP:IO1=ALL;
IO DEVICE DATA

ALPHANUMERIC DEVICES
IO RP EM DVPMR STANDBY DET LINE COMMATT ATT STATE
AD-1 50 COMMATT
AD-2 50 COMMATT BLOCK
AD-0 COMMATT
AD-100 COMMATT

END

<APLOC;
Microsoft(R) Windows NT(TM)
(C) Copyright 1985-1996 Microsoft Corp.

prompt> cpdlist
DEVICE SEP TYPE TIME LINES FF EOL EOP PRCA PARAMETER
AD-0 No File 0 - - none none - -f .
AD-100 No File 0 - - none none - -f .

prompt> exit

WO INGO1/I19/CNM204/APM AD-32 TIME 010119 1033 PAGE 1

<IOROP;
IO PRINTOUT ROUTING DATA

PRCA IO DTYPE CLASSA CLASSUA COND SYSDEV

0&&34 AD-0 FIRST 0&1&2&3&4&5 0&1&2&3&4&5 2 YES
35 AD-100 FIRST 0&1&2&3&4&5 0&1&2&3&4&5 2 YES
36&&127 AD-0 FIRST 0&1&2&3&4&5 0&1&2&3&4&5 2 YES
128&&255

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 AD-543 TIME 010117 1027 PAGE 1

<iostp;
IO DEVICE STATUS

IOIND STATE SUBSTATE COMMAND USERB USERP USERO FO DEVICE

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

Man-Machine Language, Commands, Execute Page 8 of 15

H'7C00 USERCON WRITES IOSTP SEC 12 9 2 Y AD-548(17273)

DEVICE SEIZURE STATUS

WO INGO1/I19/CNM204/APM AD-543 TIME 010117 1027 PAGE 2

SIZIND USERB PRCA STATUS RESPTIME DEVICE TYPE
NONE

END

<iostp;
IO DEVICE STATUS

WO INGO1/I19/CNM204/APM AD-543 TIME 010117 1028 PAGE 3

IOIND STATE SUBSTATE COMMAND USERB USERP USERO FO DEVICE
H'7C00 USERCON WRITES IOSTP SEC 12 9 2 Y AD-548(17273)

DEVICE SEIZURE STATUS

SIZIND USERB PRCA STATUS RESPTIME DEVICE TYPE

NONE

WO INGO1/I19/CNM204/APM AD-543 TIME 010117 1028 PAGE 4

END

<sycli;
SYCLI;
<;
ORDERED

< <CTRL-D>

WO INGO1/I19/CNM204/APM AD-543 TIME 010117 1029 PAGE 1

COMMAND LOG ACTIVATION RESULT

RESULT
FAULT CODE 45
DEVICE FAULT

END

<CTRL-M>
WO INGO1/I19/CNM204/APM AD-543 TIME 010117 1029 PAGE 1
<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 TIME 010119 1039 PAGE 1

<IOCDI:APPL=TEST,STR="$Lower case$";

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 NUM STR

TEST Lower case
CPF 1
MML01

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 AD-10 TIME 000626 1809 PAGE 1

<<CTRL-D>

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 AD-20 TIME 000626 1810 PAGE 1

<DPWSP;
CP STATE

MAU SB SBSTATE
NRM B 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 AD-20 TIME 000626 1810 PAGE 1

COMMAND LOG ACTIVATION RESULT

RESULT
FAULT CODE 93
NO SUBFILE DEFINED

END

WO BIO 8.1 R312/00/04 W749 AD-20 TIME 000626 1812 PAGE 1

STORAGE BANK STATISTICS

BANKTYPE SIZE NIU MNIU NCONG

32 1100 28 30 0
64 2000 16 19 0
128 1100 35 37 0
256 50 2 10 0
512 250 1 2 0
1K 1100 4 6 0
2K 600 2 3 0
4K 200 0 0 0
8K 200 0 0 0
16K 100 0 0 0
32K 100 0 0 0
END

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 SB SBSTATE
NRM B 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 B 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 Lower Case CPF 1

file://C:\Program Files\ALEX\Lib\ALEX_TMP\1005\alex0344.htm 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