MML Command Execute PDF

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

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

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.
Device number
-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.
Device number
-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.
-s

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.
-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.

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

(<ENTER>) is pressed, the CP prompt is received. The MML session is closed by using command
EXIT.
prompt> mml -a

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

COMMAND LOG ACTIVATION RESULT
RESULT
ACTIVATED
END

*** 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>
<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

exit . Next, command IOROP is executed. Finally, the MML session is closed by using command
EXIT.
prompt> mml

<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

<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

<iostp;
IO DEVICE STATUS

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

NONE
END
<iostp;
IO DEVICE STATUS

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

NONE

END
<sycli;
SYCLI;
<;
ORDERED
< <CTRL-D>

RESULT
FAULT CODE 45
DEVICE FAULT
END
<CTRL-M>
<exit;
prompt>
4.5 Example: 5
This is an example of how to preserve lower case letters in an MML session.
prompt> mml

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

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

<DPWSP;
CP STATE
MAU SB SBSTATE
NRM B WO
END
<SYCLI;
ORDERED
<LABUP;
ORDERED
<EXIT;
prompt>

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.

RESULT
FAULT CODE 93
NO SUBFILE DEFINED
END

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

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

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.

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.

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

exit(1)

MML Command Execute PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

MML Command Execute PDF

Uploaded by

Copyright:

Available Formats

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

MANUAL PAGE 1/190 80-CNZ 218 1104 E

Man-Machine Language, Commands, Execute

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

mml [ -s] [ -d device] [ - i device -I device] [ -r time] [ -w time] command ...

mml [ -bcs] [ -l line] [ -r time] [ -w time] - f file

Receive spontaneous printouts

Requested Input/Output (IO) device

Expressed as AD-n where:

Signed integer 0 - 1023

MML command file

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

Expressed as AD-n where:

Signed integer 0 - 1023

Expressed as AD-n where:

Signed integer 0 - 1023

Signed integer 1 - 2 147 483 647

Select Central Processor (CP) side

Connect to CP-EX? yes/[no]:

yes, establishes a connection to the Executive (EX) side of the CP.

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

Connect to separated CP side

Lines per page

Format 1, MML Session

Format 2, MML Command

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

If an ampersand (&) is included in the command, the command must be surrounded by

Format 3, MML Command File

WO INGO1/I19/CNM204/APM AD-37 TIME 010119 1041 PAGE 1

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

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

IOIND STATE SUBSTATE COMMAND USERB USERP USERO FO DEVICE

DEVICE SEIZURE STATUS

SIZIND USERB PRCA STATUS RESPTIME DEVICE TYPE

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

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

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

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

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

PRCA IO DTYPE CLASSA CLASSUA COND SYSDEV

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

IOIND STATE SUBSTATE COMMAND USERB USERP USERO FO DEVICE

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

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

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

DEVICE SEIZURE STATUS

SIZIND USERB PRCA STATUS RESPTIME DEVICE TYPE

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

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

WO INGO1/I19/CNM204/APM AD-36 TIME 010119 1039 PAGE 1

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

APPL NUM STR

prompt> mml -d AD-10

WO BIO 8.1 R312/00/04 W749 AD-10 TIME 000626 1809 PAGE 1

prompt> mml -I AD-10 -c

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

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

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

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

BANKTYPE SIZE NIU MNIU NCONG

prompt> mml DPWSP