A-AUTO for UNIX
A-AUTO for LinuxA-AUTO for Windows
V7. 2 .2

Operation Guide
2nd Edition

A-AUTO is a registered trade mark of BSP Inc. "This product includes software developed by the Apache
Software Foundation (http://www.apache.org/)." All other trademarks are property of their respective companies.
Product information specified in this manual is subject to change without notice.
©BSP Incorporated May 2012, 2nd Edition No part of this manual may be reproduced or transmitted in any form or by
any means.
EAUT-UW-722-040-2

About this ManualThis manual describes the operations of A-AUTO for UNIX A-AUTO for Windows A-AUTO for Linux systems. For
messages displayed by Windows application, please refer to the manual provided by the application.

The Conventions of Marks/Special Expressions used in this document
The conventions of marks and special expressions included in the text are explained below.

■MarksMark

Description[]

Indicates a reference.

““

Indicates a title of the window.

Note)

Indicates additional information or explanation.

‘

Indicates an item displayed on the window.

“

Indicates an item defined by the user.

/

Separates a selection of items when it appears within {}.

■Special Expressions
Expression
yyyy, yy

Description
A number that represents year in 2 or 4 digits. When 2 digit, if 70<=yy<=99, yy represents
19yy year, else yy represents 20yy year.
[Example] 95: 1995

02: 2002

mm

A number that represents month (01-12) when referred in datedd

A number that represents date (01-31)

hh

A number that represents hour (00-23)mm

A number that represents minute (00-59) when referred in timess

A number that represents second (00-59)

The conventions of marks and special expressions included in commands or parameters are explained below.

■The following marks have special meanings
Mark
{ }

Description
Indicates a selection of items. Items are separated by ‘/’. Select an appropriate item fromthe list.

[]

Indicates an item can be omitted. If omitted, a default value is applied.

…

Indicates repetitive items. Multiple commands or parameters can be specified. A single
specification is also accepted.

∆

Indicates blank.

■The following marks are specified as explained.
Mark

Description

,

Comma

=

Equal sign(

Left parenthesis)

Right parenthesis*

Asterisk－

Hyphen‘Apostrophe indicates items displayed on the window when it is used in the text.

/

Slash separates a selection of items when it appears within {}.

■Please refer to the explanation when issuing commands and setting parameters.

A-AUTO for UNIX/Windows Manuals
The following is a list of manuals for A-AUTO for UNIX/Windows and a brief description of each manual.

A-AUTO for UNIX/Windows User’s Guide

Describes the functions of A-AUTO for UNIX/Windows system.
[Target audience: System Administrator / Operation Manager / Operator]

A-AUTO for UNIX/Windows System Administrator’s

Describes the system parameters and environment variables settings, and system
maintenance, resources required to run the system, limitations of the system.
[Target audience: System Administrator / Operation Manager / Operator]

A-AUTO for UNIX/Windows Operations Guide◆This document

Describes the operating procedures such as commands of the system, and the utilities of
A-AUTO for UNIX/Windows.
[Target audience: System Administrator / Operation Manager / Operator]

A-AUTO for UNIX/Windows Setup Guide

Describes the procedures to install and setup the A-AUTO for UNIX/Windows System.
[Target audience: System Administrator / Operation Manager / Operator]

A-AUTO for UNIX/Windows Messages & Codes

Explanation of messages output by A-AUTO for UNIX/Windows and is provided in
html format.
[Target audience: System Administrator / Operation Manager / Operator]
Messages & Codes is included in the installer of A-AUTO server.
User can view Messages & Codes from the PC where A-AUTO Server is installed.
Choose [Message & Code] from [Program] - [BSP] - [A-AUTO for Windows] of Windows
Start menu.

1. Monitor Commands

1 Monitor Commands
You can input commands to A-AUTO Monitor.
There are two methods to input a command, as described below.
■ Batch Method
Enter the command as a parameter to the cip module.
cip∆dn■Interactive Method
Execute cip with no parameter to enter into the interactive mode of cip. Then, enter the command ininteractive mode. Enter quit command to end the interactive mode.
% cip
AUX021I A-AUTO/UNIX (WindowsNT) V02.0.2
AUX022I (C) Copyright 1994 BSP Incorporated, Tokyo, Japan. All Rights Reserved.
AUX301A Please input command or ‘quit’:
quit%

e.g. 1-1

Command input using Batch and Interactive methods
Input a command to release Network Queue of A-AUTO Monitor.

In the case of Batch method
cip∆aqIn the case of Interactive methodaqThis chapter describes the functions and the input format of each command. The input format using batch
method is described. The command input to A-AUTO Monitor can be in capital letters or lower case letters.
For convenience, the commands of A-AUTO Monitor are shown in lower case letters in this manual.

1-1

1. Monitor Commands

Note
When special characters (# @ ¥) are used in Network or Job ID, enclose the input command in ‘ ’. For
example, to use Release command to release @ANET01 (Network), input the command as follows.
cip∆’a@ANET01’

After cip command is entered, do not use Ctrl+C to forcefully terminate it before receiving a response
from the command. Performing Ctrl+C before the response will result in receiving only the command resultof executing Ctrl+C.

1-2

1. Monitor Commands

1.1

Command Log of A-AUTO for Windows
In A-AUTO for Windows, when system parameter AUTO_LOGTIMEON is set to 1, additional informationsuch as the name of the command/utility, and the date and time of command/utility will be appended to thedisplay.
Note that the additional information is appended to the console log display in the format: [yyyy/mm/dd
hh:mm:ss utility name:].

(1) If AUTO_LOGTIMEON is set to 1
・dt command
C:\>cip dt
2004/05/22 19:53:12 cip: AUX001I COMMAND VALID
2004/05/22 19:53:12 cip: AUX739I PDATE = 2004/05/22 TIME = 19:53:12
2004/05/22 19:53:12 cip:・mdump utility
C:\>mdump sysid
2004/05/22 20:07:10 mdump: DATE: 2004/05/22 TIME: 20:07:10
2004/05/22 20:07:10 mdump:
2004/05/22 20:07:10 mdump:
SYSID
2004/05/22 20:07:10 mdump:
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
0123456789ABCDEF
2004/05/22 20:07:10 mdump: 000000 00 00 00 00 41 55 54 4F 30 31 00 00 00 00 00
00 ....AUTO01......
2004/05/22 20:07:10 mdump: 000010 00 00 00 00 00 00 00 00 00 00 00 00 56 34 4C 56 ............V4LV
2004/05/22 20:07:10 mdump: 000020 30 36 41 00 00 00 00 00 00 00 00 00
06A.........

(2) If AUTO_LOGTIMEON is set to 0
・dt command
C:\>cip dt
AUX001I COMMAND VALID
AUX739I PDATE = 2004/05/22 TIME = 20:01:51
・mdump utility
C:\ >mdump sysid
DATE:2004/05/22 TIME:20:07:10
SYSID
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0123456789ABCDEF
000000 00 00 00 00 41 55 54 4F 30 31 00 00 00 00 00 00 ....AUTO01......
000010 00 00 00 00 00 00 00 00 00 00 00 00 56 34 4C 56 ............V4LV
000020 30 36 41 00 00 00 00 00 00 00 00 00
06A.........

1-3

1. Monitor Commands

1.3

1.3.1

Detailed Descriptions of Monitor Commands

Release Command ( A Command) )Release Command is a command that can be used to perform the following to release their Hold status.

 Release NP (Network Partition)
 Release JP (Job Partition)
 Release a Network Release Network Queue
Conversely, use Hold Command to hold (change to Hold status) a Network, a Partition or Queue..

1-5

1. Monitor Commands■ Release of NP (Network Partition)(1) Function
Release a specific NP which has been held. A NP is referred to by a number.

(2) Command Input
anp number [-end number]<1><2><1>number: Specify the NP Number to release.

<2>end number: Specify the end NP number to release.

Specify this only if a range of NPs is to bereleased, in which case the NPs to release will be from the first NP number to the end NP number
specified.
Note
If the specified NP number is larger than the maximum Partition Number defined in system parameter, thenNP released will be up to the maximum Partition Number.

e.g.1-2

Release by NP Number
Release NP001 which has been held.
anp001
A-AUTO Monitor receives this command and output the following messages on the console. The Network
Partition 1 is released.
AUX001I COMMAND VALID
AUX773I NP PARTITION 1 IS RELEASED SUCCESSFULLY

1-6

1. Monitor Commands■ Release of JP (Job Partition)(1) Function
Release a specific JP which has been held.

A JP is referred to by a number.

(2) Command Input
ajpnumber [-end number]<1><2><1>number: Specify the JP Number to release.

<2>end number: Specify the end JP number to release.

Specify this only if a range of JPs is to bereleased, in which case the JPs to release will be from the first JP number to the end JP number specified.
Note
If the specified JP number is larger than the maximum Partition Number defined in system parameter, thenJP released will be up to the maximum Partition Number.

e.g.1-3

Release by JP Number
Release JP001 which has been held.
ajp001
A-AUTO Monitor receives this command and output the following messages on the console. The Job
Number 1 is released.
AUX001I COMMAND VALID
AUX410I JP PARTITION 1 IS RELEASED SUCCESSFULLY

1-7

1. Monitor Commands■ Release of Specific Network(1) Function
Release a specific Network which has been held.

(2) Command Input
aNetwork[,SDATE=Date]<1><2><1>Network: Specify the Network to release.

<2>Date: Specify Schedule Date of the Network to be released in the format ofyyyymmdd or yymmdd.

e.g. 1-1

Release of Specific Network
Release ANET0002 (Network) which has been held.
aanet0002
A-AUTO Monitor receives this command and output the following messages on the console. The specified
Network is released.
AUX001I COMMAND VALID
AUX758I NETWORK ANET0002 SDATE=2004/05/20 IS RELEASED SUCCESSFULLY

Note
If sdate is not specified in Release command, the following will be applied.
If system parameter “NCP_USE_OLDESTDATE” is set to 1, the earliest Network will be the target to bereleased. If system parameter “NCP_USE_OLDESTDATE” is set to 0, which is the default value,
Operation Date will be applied.

1-8

1. Monitor Commands■ Release of Network Queue(1) Function
Release Network Queue which has been held.

(2) Command Input
aq

e.g.1-5

Release of Network Queue
Release Network Queue which has been held.
aq
A-AUTO Monitor receives this command and output the following messages on the console. Network
Queue is released.
AUX001I COMMAND VALID
AUX410I NETWORK QUEUE HAS BEEN RELEASED SUCCESSFULLY

1-9

1. Monitor Commands

1.3.2

Cancel Command (C Command)
Cancel Command is used to cancel a Network which is waiting for execution or is executing in A-AUTO
Monitor. Cancel Command has the following cancellation modes.
 COLD Cancel
When A-AUTO Monitor receives this command and the specified Network is executing, it will
immediately forced terminate executing Jobs of the Network and then terminate the Network itself. If
the Network is waiting for execution i.e. in the Network Queue, the Network will be removed from the
Network Queue.
 WARM Cancel
When A-AUTO Monitor receives this command, it will stop starting any job of the specified network andwait for all executing jobs of the Network to end. When all executing jobs in the Network have ended, it
will terminate the Network itself.
 FORCE Cancel
When A-AUTO Monitor receives this command, it will force the JP and NP, in which the specified
Network is executing in, to “ended” status.
The specified Network will be terminated but A-AUTO Monitor does not cancel the executing jobs of the
Network.

Note●

COLD Cancel forced terminates Job process running in OS (In UNIX, it is the same as using killcommand.). This command can also be issued for R/3 Jobs or OracleEBS Jobs that are executed in
SAP/R3 or Oracle (other systems) under the control of A-AUTO system. However, it may happen that
this command may not be able to forced terminate the process in OS or the Job running in the othersystems. If COLD Cancel command is issued and the executing Job could not be terminated, it isnecessary to check the execution status of the Job. It may be necessary to use FORCE Cancel toterminate the Network.

●

FORCE Cancel is the same as COLD Cancel except that it does not issue a request of forced
termination to the Job running in OS or the Job running in the other systems. When FORCE Cancel
command is entered, the specified Network will be removed from the NP and JP that the Network
executes in. But the Job in OS or other systems may still be running. The NP and JP freed up may be
assigned to a new Job by A-AUTO Monitor. This may cause inconsistency. (Please refer to FORCE
Cancel command for detailed explanation, and note the steps to resolve this situation).

If sdate is not specified in Cancel command, the following will be applied. If system parameter“NCP_USE_OLDESTDATE” is set to 1, the executing Network will be the target to be cancelled if there isa Network that is being executed. (If there is no executing Network, the earliest Network in Queue will be
the target Network to be cancelled.)
If system parameter “NCP_USE_OLDESTDATE” is set to 0, which is the default value, Operation Date will
be applied.

1-10

1. Monitor Commands■ COLD Cancel(1) Function
When A-AUTO Monitor receives this command and the specified Network is executing, it will immediately
forced terminate Jobs of the Network that are executing and then terminate the Network itself. If the
Network is waiting for execution i.e. in the Network Queue, the Network will be removed from the Network
Queue. (Default)(2) Command Input
c Network[,c][sdate=Date][,free=y]
<1>
<2>
<3>
<1>Network:

Specify the Network to be canceled.

<2>Date:Specify Schedule Date of the Network to be canceled in the format ofyyyymmdd or yymmdd. (Default: Operation Date)<3>free=y:Specify whether the Network is to be Free On at the same time.

Free On

marks the Network as “Normal End” status so that its succeeding Networks
can be released for execution.
*If mode of cancel [,c] is to be specified, it must be specified following [Network <1>].
e.g.1-6

COLD Cancel
Cancel ANET0001 (Network) by entering the following command.
canet0001,c,sdate=040520
A-AUTO Monitor receives this command and then output the following messages on the console.
ANET0001 (Network) is canceled.
AUX001I COMMAND VALID
AUX409I NETWORK ANET0001 REQUESTED TO BE CANCELED AT NJP

Note
If NCP_USE_OLDESTDATE is set to 1
and the specified Network is executing, A-AUTO Monitor will cancel it.

If there is no executing Network

but there are Networks with the specified Network name in the Queue, i.e. waiting for execution, then
A-AUTO Monitor will cancel the Network with the earliest Schedule Date.

1-11

1. Monitor Commands■ WARM Cancel(1) Function
This command is used to terminate the Network. If there are Jobs in the specified Network that are
executing at this time, terminate (cancel) the Network only after these Jobs has ended.

(2) Command Input
cNetwork,w[,sdate=Date][,free=y]
<1>
<2>
<3>
<1>Network:

Specify the Network to be canceled.

<2>Date: Specify Schedule Date of the Network to be canceled in the format of yyyymmdd or
yymmdd. (Default: Operation Date)<3>free=y:Specify whether the Network is to be Free On at the same time.

Free On marks

the Network as “Normal End” status so that its succeeding Networks can be released
for execution.

e.g.1-7

WARM Cancel
Cancel ANET0001 (Network) by entering the following command.
canet0001,w
A-AUTO Monitor receives this command and then output the following messages on the console.
ANET0001 (Network) is canceled.
AUX001I COMMAND VALID
AUX409I NETWORK ANET0001 REQUESTED TO BE CANCELED AT NJP

1-12

1. Monitor Commands■ FORCE Cancel(1) Function
This command should be used as an emergency measure, when COLD Cancel or WARM Cancel has
been issued but the Network could not be ended because of some abnormal conditions. When A-AUTO
Monitor receives the command, it will force the JP and NP, in which the specified Network is executing in,to “ended” status. At this time, it will terminate the specified Network.

However, cancel command will not

be issued to the executing Jobs of the Network.

(2) Command Input
cNetwork,f[,sdate=Date][,free=y]
<1>
<2>
<3>
<1>Network:

Specify the Network to be canceled.

<2>Date:Specify Schedule Date of the Network to be canceled in the format ofyyyymmdd or yymmdd. (Default: Operation Date)<3>free=y:Specify whether the Network is to be Free On at the same time.

Free On

marks the Network as “Normal End” status so that its succeeding Networks
can be released for execution.
e.g. 1-8 FORCE Cancel
Cancel ANET0001 (Network) by entering the following command.
canet0001,f,sdate=040520
A-AUTO Monitor receives this command and then output the following messages on the console.
ANET0001 (Network) is canceled.
(3) Limitation of FORCE Cancel
FORCE Cancel should be used only when COLD/WARM Cancel is ineffective and the Network cannot beterminated.
FORCE Cancel will cause A-AUTO Monitor to be in the following state.
・An execscr process remains in system.
・UDP port that the execscr was using will not be released. (This is because execscr remains in thesystem)In this state, the JP partition in which the job was running in and then canceled by Force Cancel cannot
be used.

This is because there are inconsistencies between the JP Number and the execution

management of the Job by A-AUTO Monitor.

To avoid this problem, the execscr that remained needs tobe terminated before a FORCE Cancel command by following the procedures listed below.
1-13

1. Monitor Commands

Please perform the operation carefully when entering kill command and FORCE Cancel.

<1> Before using FORCE Cancel, please check JP Number of the JP that the job is executing in.
$ cip da,all<2> Input COLD Cancel command and check again that the Job has not been canceled.
$ cip cNETNAME,c,sdate=YYMMDD<3> Login to the system where the Job is executed. Check the execution state of Job and, if it is in
executing state, force it to terminate. After forcing the Job to terminate, Network may also be
terminated by A-AUTO Monitor. In this case, please check the termination status of Job is the status
other than ”Normal End”.
・In the case of UNIX Job:
Login to UNIX to check process ID of Job by using “ps –ef| grep Job name ”.

Then, terminate Job by using kill command with the process ID.
・In the case of Windows Job:
Start Windows Task Manager and select the Job in [Processes] tab. Then, click [End Process] toend it.
・In the case of R/3 Job:
Login to SAP GUI R/3 System and terminate the executing R/3 Job.
・In the case of OracleEBS Job:
Login to OracleEBS and cancel the executing OracleEBS Job.
<4> After forcing the Job to terminate by using step <3> and, if A-AUTO Monitor still did not detect the endof Job, then force execscr process of this Job to terminate.
・If A-AUTO Monitor is installed in UNIX environment:
Check whether the process still exists or not and note the JP Number by using step <1>. Obtainprocess ID by using ”ps –ef| grep execscr”. Then, force execscr process to terminate by using killcommand with the process ID.
・If A-AUTO Monitor is installed in Windows environment:
Start Windows Task Manager and select the process ID of execscr.exe. Click [End Process] to end
it.
<5> Enter FORCE Cancel Command.
$ cip cNETNAME,f,sdate=YYMMDD

1-14

1. Monitor Commands<6> Make sure that the Network is removed from Execution Partition (NP and JP) in which the Network /Job had executed in.
$ cip da,all<7> Please make sure there is no defunct process remaining.
$ ps -ef| grep defunct | grep auto

<8> If defunct process remains, you must restart A-AUTO Monitor. To restart, ensure no job is executing,shutdown A-AUTO Monitor and then start A-AUTO Monitor with Warm option.
$ cip hq
$ cip close$ mcp warm &*If no COLD Cancel was issued prior to FORCE Cancel, the following message will be displayed and
FORCE Cancel is ignored.
AUX809W NETWORK Network SDATE=yy/mm/dd CAN NOT FORCE CANCEL, MUST COLDCANCEL AT FIRST(4) Log when FORCE Cancel
Please note that when FORCE Cancel is executed, no cancellation information will be recorded in Log file
(log0) or in tom file (toml).
The status of the Network recorded in Check file (chkl) is cancel, and status shown in Monitoring screen is“Canceled in Queue”.
UNIX example:$ cip cbspsta,f
AUX001I COMMAND VALID
AUX868I NETWORK BSPSTASDATE=2007/03/20 AT NP 001 HAS BEEN CLEARED BY FORCECANCEL$ log02004/05/24 18:59:23 log0: AUX008I NETWORK LOG FILE EMPTY$ toml2004/05/24 18:59:24 toml: AUX008I NETWORK TOM IS EMPTY

1-15

1. Monitor Commands

1.3.3

Display Command (D Command)
Display Command is used to display the following operation status of A-AUTO Monitor.

 Display the Executing Networks.
 Display the Network Queue (Networks waiting for execution).
 Display the information of Network Log File.
 Display the information of a specific Network.
 Display Operation Date.

1-16

1. Monitor Commands■ Display the Executing Networks(1) Function
Display –Networks that are currently executing in A-AUTO Monitor.

(2) Command Input
da[,type]<1><1>type:

Select the display type from the following.
n:Display NP Numberj:Display JP Number

all :Display all of NP Number and JP Number

1-17

1. Monitor Commands

e.g. 1-9 Display the Executing Network
Enter the following command to display the status of all NP and JP partitions, and the Networks currently
executing in them. NP and JP partitions without Networks executing in them are also shown.
da,all
A-AUTO Monitor receives this command and output the following messages on the console. It displays all
NP and JP partitions, and the Network currently executing in them, if any.
AUX001I COMMAND VALID
AUX426I *** ACTIVE NETWORK DISPLAY *** TIME=10:40:54
AUX024I AUTOPROC:AUTO01 MODE:PRODUCTION
AUX444I NP# C NST NETWKSDATE
JP# N O JOB-NAME SSTIMEAUX445I
1A
OLTM03 2005/01/28 1 A A OLTM0301
10:40:49
AUX445I
2A
2 A A OLTM0302
10:40:49
AUX445I
3A
3 A A OLTM0303
10:40:49
AUX445I
7A
7 A A OLTM0307
10:40:50
AUX438I *** END OF ACTIVE NETWORK DISPLAY ***

1-18

PID
1776
1856
1732
1872

1. Monitor Commands

The explanation of items displayed (da, all)When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Position

LengthExplanation

NP#

9

3

NP Number

C

13

1

Class of NP

NST

15

1

The status of NP and the status of the executing Network
C : Cancel command has been issued for the Network.
S : Stop command has been issued for the Network.
H : NP is in the held state.

NETWK

19

8

Network Name

SDATE

28

10

Schedule Date

JP#

39

3

JP Number

N

43

1

Class of JP

O

46

1

Execution Class of OS(Unused)

JOB-NAME

49

8

Job NameS

58

1

The state of JP
H : JP is in the held state.

STIME

62

8

Start time of Job

PID

71

10

Process ID of execscr

Display currently executing Networks and the NP partitions that they execute in.
da, nAccording to this command, the following messages will be displayed. It displays currently executing
Networks.
AUX001I COMMAND VALID
AUX426I *** ACTIVE NETWORK DISPLAY *** TIME=15:51:25
AUX024I AUTOPROC:AUTO81 MODE:PRODUCTION
AUX431I NP# C STT NETWORK SDATETYPE ACTIVE-JOB# START-TIME
AUX432I
1A
BSPSTA
2005/09/26
N 1
15:51:21
AUX438I *** END OF ACTIVE NETWORK DISPLAY ***1-19

1. Monitor Commands

The explanation of items displayed (da, n)
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Position

LengthExplanation

NP#

9

3

NP Number

C

13

1

Execution Class

STT

17

1

the status of the executing Network
C : Cancel command has been issued for the Network.
S : Stop command has been issued for Network.
H : NP is in the held state.

NETWORK

20

8

Network Name

SDATE

29

10

Schedule Date

TYPE

43

1

Execution Type N: Normal Type

R:Rerun Type

F:Force Type
ACTIVE-JOB# 44

3

Number of executing Jobs in the Network

START-TIME

8

Start time of Network

57

Display currently executing Jobs and the JP partitions that they execute in.
da,jAccording to this command, the following messages will be displayed. It displays currently executing Jobs.
AUX001I COMMAND VALID
AUX426I *** ACTIVE NETWORK DISPLAY *** TIME=15:50:53
AUX024I AUTOPROC:AUTO81 MODE:PRODUCTION
AUX433I JP# C NETWORK SDATEJOB
S-TIME
AUX434I
1 A BSPSTA
2005/09/26 BSPSTA02
AUX438I *** END OF ACTIVE NETWORK DISPLAY ***The explanation of items displayed (da, j)
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Position

LengthExplanation

JP#

9

3

JP Number

C

13

1

Class of JP

NETWORK15

8

Network Name

SDATE

26

10

Schedule Date

JOB

38

8

Job Name

S-TIME47

8

Start time of Job

1-20

1. Monitor Commands■ Display the Networks Waiting for Execution(1) Function
Display the information of Networks waiting for execution in the Network Queue.
(2) Command Input
dn[,type]<1><1>type:

Select the display option from the following.
class=Class:

Display Networks with the specified Class only.

Sdate=Date:

Display Networks for the specified Schedule Date
only. The date is specified in the format ofyyyymmdd or yymmdd.

Net =Network:

Display the information of the specified Network.
(Prefix can be specified to display only Networks
whose Network name starts with the specified
prefix.）g =Network Group:
Display Networks belonging to the specified
Network Group only.

1-21

1. Monitor Commands

e.g.1-10

Display the Wait Network
Enter the following command to display Networks of Class A.
dn，class=a

A-AUTO Monitor receives this command and output the following messages on the console. It displays
Networks of Class A.
AUX001I COMMAND VALID
AUX701I *** NETWORK QUEUE DISPLAY ***AUX702I S-DATE CL NETWORKS
AUX703I 2004/05/20 A AFDL0001() AF01() AFKH01
AUX703I 2004/05/20 A AFKL0001() AFTD01 () AFXM01
AUX703I 2004/05/20 A ANET02 () ANET03 () ANET04 (H
AUX703I 2004/05/20 A BNET01 () BNET02 () BNET03 (AUX703I 2004/05/20 A BNET04 () BSPEND () C1()
AUX703I 2004/05/20 A C2(
) OLTM01 () OLTM02 (AUX703I 2004/05/20 A OLTM06 () OLTM07 () OLTM08 (AUX703I 2004/05/20 A OLTM09 () OLTM10 () OLTM11 (AUX703I 2004/05/20 A OLTM12 (H ) OLTM13 () OLTM14 (AUX703I 2004/05/20 A OLTM15 () OLTM1A () OLTM1B (AUX703I 2004/05/20 A SKDS0003 () SKDS0004 () XMAD01
AUX703I 2004/05/20 A XMAD02 () XMAD03 () XMAD04 (AUX703I 2004/05/20 A XMKH01 () XMKH02 () XMKH03 (AUX703I 2004/05/20 A XMKH04 (
)

(
(
)
)
)
)
)
)
)
(
)
)

)
)

)

The explanation of items displayed
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Position

LengthExplanation

S-DATE

9

10

Schedule Date

CL

20

1

Execution ClassNETWORKS

23,38,53 8

Network Name

32,47,62 1

Wait Condition (Hold wait)
Alphanumeric character: A Hold Code character displayed in thiscolumn indicates that Hold wait condition is not cleared

33,48,63 1

Wait Condition (Data Wait)
I: Data Wait condition is not cleared

34,49,64 1

Wait Condition(Start Time Wait)
T: Start Time Wait condition is not cleared

1-22

1. Monitor Commands■ Display the information of Network Log File
(1) Function
A-AUTO Monitor records the termination information of a Job in Network Log File. Display Log command isa Monitor command to display the information of Network Log File on the console. When the command isissued to A-AUTO Monitor, it will display the Job termination information of the most recent 20 Jobs that
had ended.

(2) Command Input
dl[,type]<1><1>type:

Select the display option from the following.
G=Network Group:
Display the termination information of jobs whose
Networks belong to the specified Network Group
only.

e.g. 1-11Network Log File Display
Enter the following command to display the Job termination information of the most recent 20 Jobs that had
ended.
dl
A-AUTO Monitor receives this command and output the following messages on the console. It displays thetermination information of Jobs that had ended.
AUX001I COMMAND VALID
AUX414I *** DISPLAY LOG *** TIME=14:25:12
AUX415I JOBNAME NETWORK … SDATERUN START - END RC LID RSYSQ
USER-ID
AUX416I OLTM0401 OLTM04 … 2010/10/18 R 1424
1424 12 0
AUTOUSER
AUX416I BSPSTA01 BSPSTA … 2010/10/18 N 1424
1425 00
ADMIN
AUX416I BSPSTA02 BSPSTA … 2010/10/18 N 1425
1425 00
AUTOUSER
AUX417I CURRENT LOG = NETWORK-LOG X,
0.75 PER CENT ALLOCATED
AUX437I *** END OF NETWORK LOG DISPLAY ***1-23

1. Monitor Commands

The explanation of items displayed
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Position

LengthExplanation

JOBNAME

98

Job Name

NETWORK

19

8

Network NameGROUPID

28

8

Network Group Name

SDATE

37

10

Schedule Date

RUN

50

1

Execution Type N: Normal Type

START

52

4

Start time

END

60

4

End time

RC

66

2

Job Return Code

LID

71

1

Job Library ID

RSYSQ

73

8

System Qualifier Name

USER-ID

82

8

Job Executing User ID

1-24

R:Rerun Type

1. Monitor Commands■ Display the information of Specific Network(1) Function
Display the detailed attribute information such as Class, Job composition and so on, of a specific Networkin A-AUTO Monitor.

(2) Command Input
dNetwork[,sdate=Date][,state]
<1>
<2>
<3>
<1>Network: Specify the Network whose information is to be displayed.

<2>Date: Specify Schedule Date of the Network to be displayed in the format ofyyyymmdd or yymmdd. (Default: Operation Date)<3>state: Specify this option if the current state of the specified Network is to be
displayed.
It is valid only when the Network specified by <1> is in “executing” or ”InQueue” (waiting in Queue for execution) status.

e.g. 1-12 Display the information of a specific Network
Enter the following command to display the detailed information of the Network.
dNET00001,sdate=111129
A-AUTO Monitor receives this command and output the following messages on the console. It displays
Network attribute such as Class and Job composition, and so on.
AUX001I COMMAND VALID
AUX706I *** NETWORK NET00001 GENERAL DISPLAY *** TIME= 10:39:23
AUX707I ATTRIBUTE = PARA_RUN
AUX708I PREDECESSOR = NIL
AUX709I CLASS = A SYSQ = RMT01
JOBLIBID = 0 EXEC-TIME = 110(W) USER-ID =UID00001
AUX709I START-DELAY= 0000END-DELAY = 0000
AUX709I START-INTERVAL = 0000
END-TIME = 0000
AUX709I RESOURCE= OFF
PLUGIN(B) = OFFPLUGIN(A) = OFFAUX710I *** NETWORK NET00001 DETAIL DISPLAY ***AUX711I JNO JOBNAME PRECEDING JOB NO.
ATTR M-CD USER-ID
AUX712I 010 NETJB010
0001
AUX712I 020 NETJB020 010
0001
AUX712I 030 NETJB030 020
0001
AUX712I 040 NETJB040 030
0001
AUX712I 050 NETJB050 040
0001
AUX712I 060 NETJB060 050
0001
AUX725I *** END OF NETWORK INFORMATION DISPLAY ***1-25

1. Monitor Commands

The explanation of items displayed
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Explanation

ATTRIBUTE

Network Attributes
HOLD(c): with Hold Attributec: Hold CodeTIME(hhmm): with Start Time Attributehhmm: Start Time
PARA_RUN: with Job Parallel Run Attribute
INPUT: with Data Wait Attribute
MONITOR-ON: with Monitor On Attribute
If there is no attribute defined, it will display NIL.

Item

Explanation

PREDECESSOR

Preceding Network Name
Up to 6 Preceding Network IDs will be displayed.
If Preceding Network is not defined, it will display NIL.

Item

Explanation

CLASS

Execution Class

SYSQ

System Qualifier Name
If System Qualifier is not defined, it will display nothing.

JOBLIBID

Job Library ID

EXEC-TIME

Network’s Max Executing Time(Response To Max Time)“Response To Max Time” is one of the following:(W): Only Display Warning Message(C): Display Warning Message and perform Cancel (COLD) Network.
(Space): Max Executing Time is not set.

USER-ID

Job Executing User ID of Network

START-DELAY

Start Delay Watch Time

END-DELAY

End Delay Watch Time

START-INTERVAL Interval (min) to trigger Network
END-TIME

Time Interval End TimeRESOURCE

Resource using flag

PLUGIN(B)

Plug-in Before Start flag

PLUGIN(A)

Plug-in After start flag

1-26

1. Monitor Commands

Item

Position Length Explanation

JNO

9

3

Job Number

JOBNAME

13

8

Job Name

PRECEDING

22

23

Preceding Job Numbers

ATTR

46

4

(Unused)

M-CD

51

4

Max Return CodeUSER-ID

56

8

Job Executing User ID

JOB NO.

e.g. 1-13 Display the current state of a Network waiting for execution
Enter the following command to display the current state of a Network that is waiting for execution.
dOLTM12,state
A-AUTO Monitor receives this command and output the following messages on the console. It displays thecurrent state of Network including the status of its Preceding Networks.
AUX001I COMMAND VALID
AUX706I *** NETWORK OLTM12 GENERAL DISPLAY *** TIME= 14:26:39
AUX971I NETWORK STATE : QUEUED
AUX882I NOT CLEAR ATTRIBUTE(S): NONE
AUX710I *** NETWORK OLTM12 DETAIL DISPLAY ***AUX888I PREDECESSOR SDATESTATE
AUX883I OLTM11
2011/11/29 NORMAL END
AUX883I OLTM1B
2011/11/29 NORMAL END
AUX883I OLTM1C
2011/11/29 NORMAL END
AUX883I SKDS04
2011/11/29 NORMAL END
AUX883I XMAD04
2011/11/29 NORMAL END
AUX883I XMKH04
2011/11/29 NORMAL END
AUX970I OTHER CONSTRAINT : NETWORK QUEUE IS HELDAUX725I *** END OF NETWORK INFORMATION DISPLAY ***The explanation of items displayed
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Explanation

NETWORK

Current state of Network
QUEUED : In Queue waiting for execution

STATE

1-27

1. Monitor Commands

Item

Explanation

NOT CLEAR

Wait Conditions that have not been cleared
HOLD : Hold condition is not cleared.
TIME: Start Time Wait condition is not cleared.
INPUT : Data Wait condition is not cleared.
NONE : No Attribute defined or all wait conditions of Attributes are cleared

ATTRIBUTE(S)

Item

Position Length Explanation

PREDECESSOR 9

8

Preceding Network Name
Up to 6 Preceding Network IDs will be displayed

SDATE

21

10

Schedule Date of Preceding Network

STATE(*1)

32

28

Status of Preceding Network
QUEUED: In Queue waiting for execution
NORMAL END : Normally EndedNORMAL END(NEED MONITOR-ON) : Normally Ended
Monitor On wait condition is notclearedABNORMAL END(CANCEL) : Abnormally Ended (Network cancel)
ABNORMAL END(SCRIPT ERROR) : Abnormally Ended (script error)
ABNORMAL END(ABEND) : Abnormally Ended (Abend)
ACTIVE: executing
NOT FOUND: No execution details

Item

Explanation

OTHER

Other constraints
If all wait conditions of Network Attributes have been cleared
and the Network is still not released for execution, it displays the other constrained
conditions.
NETWORK QUEUE IS HELD : Network Queue is in Hold status.
SAME NETWORK(Schedule Date) IS Network’s status: The same Network of an earlier schedule date was
not normally ended.
WAIT FOR EXCLUSION RESOURCE: Waiting for available exclusive resource.
SPECIFIED CLASS DOES NOT EXIST: The specified Execution Class does not exist.
WAIT FOR USABLE NP: Waiting for free NP partition.
UNKNOWN REASON: Other reasons (file accessed error, plug-in loading error )CONSTRAINT(*2)(*1)In the case of rerun,

the STATE of all preceding Networks will be shown as [NORMAL END].

(*2) In the case of rerun, [SAME NETWORK~] will not be shown in OTHER CONSTRAINT.
e.g. 1-14 Display the current state of an executing Network
Enter the following command to display the current state of a Network that is executing.
dOLTM03,state
A-AUTO Monitor receives this command and output the following messages on the console. It displays thecurrent state of Network and Job.

1-28

1. Monitor Commands

AUX001I COMMAND VALID
AUX706I *** NETWORK OLTM03 GENERAL DISPLAY *** TIME= 20:51:20
AUX971I NETWORK STATE : ACTIVE
AUX972I JNO JOBNAME RC CODE REASONRSYSQAUX973I 010 OLTM0301 04
JOB CANCELED
AUX973I 020 OLTM0302 00
JOB WAS NOT EXECUTEDAUX973I 030 OLTM0303 00
JOB TERMINATED
AUX973I 040 OLTM0304 00
JOB WAS NOT EXECUTEDAUX973I 050 OLTM0305 00
JOB TERMINATED
AUX973I 060 OLTM0306 00
JOB TERMINATED
AUX973I 070 OLTM0307 00
JOB TERMINATED
AUX973I 080 OLTM0308 00
JOB TERMINATED
AUX973I 090 OLTM0309 00
EXECUTE
AUX973I 100 OLTM0310 00
JOB TERMINATEDAUX438I *** END OF ACTIVE NETWORK DISPLAY ***The explanation of items displayed
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Explanation

NETWORK

Network’s current StateACTIVE : running
PAUSE : Suspended

STATE

Item

Position Length Explanation

JNO

9

3

Job Number

JOBNAME

13

8

Job Name

RC

22

2

Job End Return Code

CODE

25

4

Job End CodeREASON

30

26

Job State
EXECUTEJOB ABENDEDJOB CANCELLEDSCRIPT ERRORJOB TERMINATE
PREVIOUS JOB ABENDED
JOB WAS NOT EXECUTEDFAILED TO LOGONJOB RECOVERY FAILED

RSYSQ

57

8

System Qualifier of Job

1-29: Running:Abnormally ended: Cancelled: Script error: Normally ended: Preceding Job abnormally ended: Job was not executed: User failed to log-in:Job failed to recover1. Monitor Commands

Acquisition of information
The information of Network and Job Attributes is obtained from the following.
 Network Attribute : Search for the files for the specified Network in the following order: Network
Queue → Daily Network Master → Network Master. It displays the informationfrom the first file that has the Network.
 Job Attribute: Information is usually obtained from Network Master.

1-30

1. Monitor Commands■ Display Operation Date
(1) Function
Display Operation Date and Time of A-AUTO Monitor on the console.

(2) Command Input
dt

e.g.1-15

Operation Date Display
Enter the following command to display Operation date and time.
dt
A-AUTO Monitor receives this command and output the following messages on the console. It displays
Operation Date and Time.
AUX001I COMMAND VALID
AUX739I PDATE = 2004/05/20 TIME = 17:27:33

1-31

1. Monitor Commands

1.3.4

Date Command (DATE Command)(1) Function
Change the Operation Date of A-AUTO Monitor.
When A-AUTO Monitor is started in COLD mode, its Operation Date is set to the CPU Date. Use thiscommand to change the Operation Date of A-AUTO Monitor to the current CPU date or a specific date.

(2) Command Input
date[=Date]<1><1>Date:Specify a new date for the Operation Date in the format of yyyymmdd or
yymmdd.
(Default: CPU Date)e.g.1-16

Operation Date Change 1
Enter the following command to change Operation Date of A-AUTO Monitor to a specific date.
Date=040521
A-AUTO Monitor receives this command and output the following messages on the console. Operation
Date is changed accordingly.
AUX001I COMMAND VALID
AUX739I PDATE = 2004/05/21 TIME = 10:34:44

e.g.1-17

Operation Date Change 2Enter the following command to change Operation Date of A-AUTO Monitor to CPU Date.
date
A-AUTO Monitor receives this command and output the following messages on the console. It changes the
Operation Date to the current CPU date and displays the new Operation Date.
AUX001I COMMAND VALID
AUX739I PDATE = 2004/05/20 TIME = 10:34:44

1-32

1. Monitor Commands

1.3.5

System Reset Command (ESYS Command)(1) Function
System Reset Command may be used to perform the following: Change Job Library ID of Networks
 Change or display Load Balance Information used by Load Balance function
 Reload or display Job Executing User information used by Job Executing User Switching function(2) Command Input
esys, {joblib=Job Library ID | l, {list | reload | sysgq= System Group Qualifier<1><2>
file name,lbsq= Candidate name of Load Balance, {on | off}} | u, {list | reload}}<3><1> joblib=Job Library ID : Change Job Library of all Networks in Network Queue to the specified Job
Library ID.
<2> l : Change or display Load Balance Information used by Load Balance function.
・l, list: Display the connection
related information.

information of distribution candidates andEither command input, “ esys,l” or “ esys,l,list”,

is acceptable.
・l, reload: Reload SYSQCONF file.
・l, sysgq=System Group Qualifier name, lbsq= Candidate name of Load Balance
function, {on | off}:Temporarily change the distribution target for the
specified distribution.
System Group Qualifier nameRegister distribution candidate.
Specify System Group Qualifier name.
Candidate name of distribution
Specify candidate name used for changing the Load Balance(System Group Qualifier name)on/offon: Add Load Balance candidate in distribution target.
off: Remove Load Balance candidate from distribution target.

1-33

1. Monitor Commands<3> u:reload or display Job Executing User information.
・u, list: Display user information from memory.
・u, reload: Reload userdef file.

1-34

1. Monitor Commands

e.g.1-18

To display information about the distribution candidates
Enter the following command to display the information of distribution candidates.
esys, l, list
A-AUTO Monitor receives this command and output the following messages on the console. It displays theinformation of distribution candidates.
AUX075I *** LBP MEMORY DISPLAY ***AUX076I SYSQPR KIND HOST
PORT LBTYPE QUELENGTH CPU
AUX077I LB01
S
LOCALHOST
7000 1-1-1
AUX077I LB04
R
REMOTE710
8000 0-1-1
AUX077I LB03
T
REMOTE722
9999 0-1-1
AUX078I SYSQPR KIND RNAMERTYPE
AUX079I LB02
A
AUTO58AS400
AUX080I SYSQPR KIND LBNAME
ON/OFF EVAL E-COEFF INTVL
AUX081I UNIX01 G
LB01
ON
1
0
60
AUX081I UNIX01 G
LB03
ON
1
0
60
AUX082I *** END OF LBP MEMORY DISPLAY ***The explanation of items displayed
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Explanation

SYSQPR

System Qualifier Name and System Group Qualifier Name

KIND

Information type of System Qualifier(SYSQPR)
T: System Qualifier Name of A-REMOTE for Windows/Linux/UNIX(V722 and later)
S: System Qualifier Name of A-REMOTE for Windows/Linux/UNIX(V710~V721)
R: System Qualifier Name of A-REMOTE for Windows/Linux/UNIX(V700 or earlier)
A: System Qualifier Name of A-REMOTE for AS400
G: System Group Qualifier NameHOST

IP Address and Host NamePORTPort Number that the remote system listens to

LBTYPE

Method of getting Load Information
0: Do not get from A-Remote (Do not take into account Load information)
1: Get from A-REMOTE.

QUELENGTH

Evaluation value of the Load Information obtained (Execute Wait Queue Length)

CPU

Evaluation value of the Load Information obtained (CPU utilization)

Item

ExplanationRNAMEAPLINK Name

RTYPE

OS Type
1-35

1. Monitor Commands

Item

Explanation

Item

Explanation

LBNAME

Load Balance candidate(SYSQPR Name)

ON/OFF

Specify distribution(Distribution target

Yes/No)

ON: Yes
OFF: No
EVAL

Evaluation method of Load Balance
0: Not Distributed (Always select 1st item of LBNAME)
1: Round Robin (Select according to the order specified in LBNAME)
2: Execute Wait Queue List (Load Information: evaluate the load by Queue Length of
Networks waiting for execution)
3: Expression (Load Information: evaluate the load by CPU utilization)

E-COEFFSet Expression
1 fixedINTVL

Monitoring Interval(Time Interval to retrieve Load Information)
Unit: secondNote

If the Network is to be started in A-Remote for OS/400 or the Network contains R/3 jobs, Job Library
ID can specify a value of 0 only. If a value other than 0 is specified, a message will be displayed andthe processing of the Network is skipped.

[esys, l, sysgq=System Group Qualifier Name, lbsq= Candidate name of Load Balance, on(off)] is acommand that temporarily add (on) or remove (off) a distribution candidate defined in SYSQCONF.
When the System is restarted or SYSQCONF file is reloaded, the content of SYSQCONF will
replace the temporary setting. If you want to remove or add a candidate from the distribution
candidates permanently, change SYSQCONF file.

1-36

1. Monitor Commands

e.g. 1-19

Display Job Executing User Information List
Display Job Executing User Information List by entering the following command.
esys, u, list
A-AUTO Monitor receives this command and output the following messages on the console. It displays Job
Executing User Information List.
AUX001I COMMAND VALID
AUX476I *** LOGON USER ID MEMORY DISPLAY *** DATE=2011/11/30 TIME=12:00:33
AUX477I NO. USER-ID DOMAINLOGON-ID
AUX478I 0001 ADMIN
bsp.co.jp
administrator
AUX478I 0002 ADMINLOC
administrator
AUX478I 0003 GUEST01
guest01
AUX478I 0004 AUTOUSR1 bsp.co.jp
autousr01
AUX478I 0005 AUTOUSR2 bsp.co.jp
autousr02
AUX478I 0006 AUTOUSR3 bsp.co.jp
autousr03
AUX478I 0007 AUTOUSR4 bsp.co.jp
autousr04
AUX478I 0008 AUTOUSR5 bsp.co.jp
autousr05
AUX478I 0009 AUTOUSR6 bsp.co.jp
autousr06
AUX479I *** END OF LOGON USER ID MEMORY DISPLAY ***The explanation of items displayed
When AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (25 columns) will be appended to theleft of each message displayed.
Item

Explanation

NO.

Sequence number of records in user information definition file.

USER-ID

Job Executing User ID

DOMAIN

Logon User Domain

LOGON-ID

Logon User ID

1-37

1. Monitor Commands

1.3.6

Reset Command (E Command)
Reset Command is used to perform the following.
 Change Attribute of Network in Network Queue (Waiting for execution)
 Change Network Attribute of Network Group Change Network Class of NP (Network Partition)
 Change Network Class of JP (Job Partition)

1-38

1. Monitor Commands■ Change Attribute of Network(1) Function
This is used to change Start Time, Priority and Execution Class of a Network that is waiting for execution in
Network Queue. It may also be used to release Data Wait condition of a Network.

(2) Command Input
eNetwork[,sdate=Date],Attribute<1> <2><3><1>Network: Specify the Network whose attribute is to be changed.

<2> Date: Specify Schedule Date of the Network to be changed in the format ofyyyymmdd or yymmdd. (Default: Operation Date)<3> Attribute: Specify the Attribute and the new value for the attribute.
time=Time: Change Start Time to the specified time(hhmm) in
the format of (hhmm).

I=n: Release Data Wait condition.

Prty=Priority: Change the Priority to the specified value.
(01<=Priority<=15)class=Class: Change the Class(1 alphanumeric character) to thespecified value.

Joblib=Job Library ID: Change Job Library ID to the specified value.

Note

If the Network is to be started in A-Remote for OS/400 or the Network contains R/3 jobs, Job Library
ID can specify a value of 0 only. If a value other than 0 is specified, a message will be displayed andthe processing of the Network is skipped.

e.g.1-20

Change Attribute of Network
Change Start Time of ANET0001 (Network) to 13:00 by entering the following command.
eanet0001,sdate=040520,time=1300
A-AUTO Monitor receives this command and then output the following messages on the console. The Start
Time is changed to 13:00.
AUX001I COMMAND VALID
AUX836I START TIME OF NETWORK ANET0001 SDATE=2004/05/20 IS RESET TO 1300 HHMM

1-39

1. Monitor Commands■ Change Attribute of Network Group(1) Function
This is used to change Priority, Execution Class and Job Library ID of all Networks belonging to thespecified Network Group.

(2) Command Inpute, g= Network Group[,sdate=Date],Attribute
<1>
<2>
<3>
<1> Network Group: Specify the Network Group to be changed.

<2> Date: Specify Schedule Date of the Network Group to be changed in the format ofyyyymmdd or yymmdd. (Default: Operation Date)<3> Attribute: Specify the Attribute and the new value for the attribute.
prty=Priority: Change the Priority to the specified value.
(01<=Priority<=15)class=Class: Change the Class (1 alphanumeric character) to thespecified value.

Joblib=Job Library ID: Change Job Library ID to the specified value.

Note

If the Network is to be started in A-Remote for OS/400 or the Network contains R/3 jobs, Job Library
ID can specify a value of 0 only. If a value other than 0 is specified, a message will be displayed andthe processing of the Network is skipped.

1-40

1. Monitor Commands

e.g.1-21

Change Network Attribute in a unit of Network Group
Change the Execution Class of all Networks belonging to GRP01 (Network Group) to A by entering thefollowing command.
e,g=GRP01,c=a
A-AUTO Monitor receives this command and then output the following messages on the console. The
Execution Class of all Networks belonging to GRP01 is changed to A.
C:\Documents and Settings\Administrator>cip e,g=GRP01,c=a
AUX001I COMMAND VALID
AUX832I CLASS OF NETWORK OLTM01 SDATE=2008/08/21 IS SET TO A
AUX832I CLASS OF NETWORK OLTM02 SDATE=2008/08/21 IS SET TO A
AUX832I CLASS OF NETWORK OLTM03 SDATE=2008/08/21 IS SET TO A
AUX832I CLASS OF NETWORK OLTM05 SDATE=2008/08/21 IS SET TO A
AUX832I CLASS OF NETWORK OLTM06 SDATE=2008/08/21 IS SET TO A
AUX832I CLASS OF NETWORK OLTM07 SDATE=2008/08/21 IS SET TO A
AUX832I CLASS OF NETWORK SKDS01 SDATE=2008/08/21 IS SET TO A
AUX832I CLASS OF NETWORK XMAD01 SDATE=2008/08/21 IS SET TO A

1-41

1. Monitor Commands■ Change Network Class of NP Partition(1) Function
This command can be used to change Execution Class assigned to NP partition. This may help to avoid
overloading to a specific class or to centralize the loading to a specific class.

(2) Command Input
enpNumber[-to Number],ncl=Class
<1>

<2>

<3>

<1> Number:

Specify NP Number (3 digits) to be changed. (Required)<2>to Number:

Specify the end NP number (3 digits) to be changed.

Specify this only if a

range of NPs is to be changed, in which case the NPs to change will befrom the first NP number to the end NP number specified.
<3>Class:

Specify the new Class (1 alphanumeric character) to be assigned to NP
Number of <1> through <2>.

e.g.1-22

Change Network Class by NP Number
Change Execution Class assigned to a range of NP Numbers from 1 to 10 to C by entering the following
command.
enp001-010,ncl=c
A-AUTO Monitor receives this command and then output the following messages on the console. The
Execution Class of NP from 1 to 10 is changed to C.
AUX001I COMMAND VALID
AUX732I NP PARTITION 1 RESET WITH CLASS C
AUX732I NP PARTITION 2 RESET WITH CLASS C
AUX732I NP PARTITION 3 RESET WITH CLASS C
AUX732I NP PARTITION 4 RESET WITH CLASS C
AUX732I NP PARTITION 5 RESET WITH CLASS C
AUX732I NP PARTITION 6 RESET WITH CLASS C
AUX732I NP PARTITION 7 RESET WITH CLASS C
AUX732I NP PARTITION 8 RESET WITH CLASS C
AUX732I NP PARTITION 9 RESET WITH CLASS C
AUX732I NP PARTITION 10 RESET WITH CLASS C

1-42

1. Monitor Commands■ Change Network Class of JP Partition(1) Function
This command can be used to change Execution Class assigned to JP.partition This may help to avoid
overloading to a specific class or to centralize the loading to a specific class.

(2) System Parameter
System Parameter NJP_JPON must be set to 1(default: 0) when you want to change the Execution Classof JP. If this Parameter is 0, Reset command for JP class will be ineffective.

(3) Command Input
ejp Number[-to Number],ncl=Class
<1>
<2>
<3>
<1> Number:

Specify JP Number (3 digits) to be changed. (Required)<2>to Number:

Specify the end JP number (3 digits) to be changed.

Specify this only if a

range of JPs is to be changed, in which case the JPs to change will be fromthe first JP number to the end JP number specified.
<3>Class:

Specify the new Class (1 alphanumeric character) to be assigned to JP
Number of <1> through <2>.

e.g.1-23

Change Network Class by JP Number
Change Execution Class assigned to a range of JP Numbers from 1 to 10 to C by entering the following
command.
ejp001-010,ncl=c
A-AUTO Monitor receives this command and then output the following messages on the console. The
Execution Class of JP from 1 to 10 is changed to C.
AUX001I COMMAND VALID
AUX401I JP PARTITION 1 RESETAUX401I JP PARTITION 2 RESETAUX401I JP PARTITION 3 RESETAUX401I JP PARTITION 4 RESETAUX401I JP PARTITION 5 RESETAUX401I JP PARTITION 6 RESETAUX401I JP PARTITION 7 RESETAUX401I JP PARTITION 8 RESETAUX401I JP PARTITION 9 RESETAUX401I JP PARTITION 10 RESET

1-43

1. Monitor Commands

1.3.7

Free Command (F Command)(1) Function
Free Command is used to forced change the end status of a Network to “Normal End” or ”Not Executed”.
This command may be used to force succeeding Networks to be released for execution even though its
preceding Network is not normally ended.

It only updates the end status of the Network and therefore, theactual state of Network remains unchanged after the command.

(2) Command Input
fNetwork[,Type][,sdate=Date]
<1>
<2>
<3>
<1>Network:

Specify the Network whose end status is to be changed.

<2>Type:

Select the end status of the specified Network to be set from the following.
(default: on)
on : Normal End (Free On)
off : Not Executed (Free Off)

<3>Date:Specify Schedule Date of Network to be changed in the format ofyyyymmdd or yymmdd. (Default: Operation Date).

*[<2>Type] must be specified immediately after [<1> Network].
e.g.1-24

Free On a Network
Free On ANET0001 (Network) by entering the following command.
fanet0001,on,sdate=040112
A-AUTO Monitor receives this command and then output the following messages on the console.
ANET0001 is Free On.
AUX001I COMMAND VALID
AUX823I NETWORK ANET0001 SDATE=2004/01/12 IS FREE ON

1-44

1. Monitor Commands

e.g.1-25

Free Off a Network
Free Off ANET0002 (Network) by entering the following command.
fanet0002,off,sdate=040112
A-AUTO Monitor receives this command and then output the following messages on the console.
ANET0002 is Free Off.
AUX001I COMMAND VALID
AUX823I NETWORK ANET0002 SDATE=2004/01/12 IS FREE OFF

1-45

1. Monitor Commands

1.3.8

Go Command (G Command)(1) Function
Go Command) is used to resume the execution of the Network which was suspended by Stop Command.

(2) Command Input
gNetwork<1><1>Network

e.g.1-26: Specify the Network which was suspended by Stop Command.

Rerun the Network which was paused by Stop Command.
Resume the execution of ANET0001 (Network) which was suspended by entering the following command.
ganet0001
A-AUTO Monitor receives this command and then output the following messages on the console.
ANET0001 continues its execution.
AUX001I COMMAND VALID
AUX412I NETWORK ANET0001 SDATE=2004/01/12 WILL GO AGAIN

1-46

1. Monitor Commands

1.3.9

Hold Command (H Command)
Hold Command may be used to to perform the following.
 Hold NP (Network Partition)
 Hold JP (Job Partition)
 Hold Specific Network
 Hold Network Queue

1-47

1. Monitor Commands■ Hold NP (Network Partition)(1) Function
Hold one or more NP partitions. A NP is referred to by a number.

(2) Command Input
hnpNumber[-to Number]<1><2><1> Number:

Specify the Number of NP to be held.

<2>to Number:

Specify the end NP number to be held.

Specify this only if a range of NPs

is to be held, in which case the NPs to hold will be from the first NP number
to the end NP number specified.
Note
If the specified NP number is larger than the maximum Partition Number defined in system parameter, thenNP held will be up to the maximum Partition Number.

e.g.1-27

Hold by NP Number
Hold NP001.
hnp001
A-AUTO Monitor receives this command and then output the following messages on the console. NP
Number NP001 is held.
AUX001I COMMAND VALID
AUX773I NP PARTITION 1 IS HELD SUCCESSFULLY

1-48

1. Monitor Commands■ Hold JP (Job Partition)(1) Function
Hold one or more JP partitions. A JP is referred to by a number.

(2) Command Input
hjpNumber[-to Number]<1><2><1> Number:

Specify the JP Number (3 digits) to be held.

<2>to Number:

Specify the end JP number to be held.

Specify this only if a range of JPs

is to be held, in which case the JPs to release will be from the first JP
number to the end JP number specified.
Note
If the specified JP number is larger than the maximum Partition Number defined in system parameter, thenJP held will be up to the maximum Partition Number.

e.g. 1-28

Hold by JP Number
Hold JP001.
hjp001
A-AUTO Monitor receives this command and then output the following messages on the console. NP
Number JP001 is held.
AUX001I COMMAND VALID
AUX410I JP PARTITION 1 IS HELD SUCCESSFULLY

1-49

1. Monitor Commands■ Hold Specific Network(1) Function
Hold a Network.

(2) Command Input
hNetwork[,SDATE=Date]<1><2><1>Network:

Specify the Network to be held.

<2>Date:Specify Schedule Date of Network to be held in the format of yyyymmdd or
yymmdd. (Default: Operation Date).

e.g.1-29

Hold Specific Network
Hold ANET0002 (Network).
hanet0002
A-AUTO Monitor receives this command and then output the following messages on the console.
ANET0002 is held.
AUX001I COMMAND VALID
AUX758I NETWORK ANET0002 SDATE=2004/01/12 IS HELD SUCCESSFULLY

1-50

1. Monitor Commands■ Hold Network Queue(1) Function
Hold Network Queue.

(2) Command Input
hq

e.g.1-30

Hold Network Queue
Hold Network Queue.
hq
A-AUTO Monitor receives this command and then output the following messages on the console. Network
Queue is held.
AUX001I COMMAND VALID
AUX410I NETWORK QUEUE HAS BEEN HELD SUCCESSFULLY

1-51

1. Monitor Commands

1.3.10 Switch Command (I Command)(1) Function
A-AUTO Monitor records the termination information of a Job in Network Log File. This Network Log File islogically divided two files, namely Network Log File X and Y. In a normal situation, the termination
information is automatically recorded in the other file when one file is full.
Switch Command is used to force the switching of the log file. When A-AUTO Monitor receives thiscommand, Log File is switched (X to Y, or Y to X).

(2) Command Input
ilog Log File
<1><1>Log File:

Specify x or Y.
In the case of specifying x.
Switch Network Log File from Y to X.
In the case of specifying y.
Switch Network Log File from X to Y.

NoteWhen Network Log File X is currently being used to record termination information and Switch
command “ilogx” is entered, it will continue recording in the file X.

Use Display Log Command to check the current Network Log File that is being use for recording
termination information.

e.g.1-31

Switch Network Log File
Switch Network Log File of A-AUTO Monitor from X to Y.
ilogy
A-AUTO Monitor receives this command and then output the following messages on the console. Network
Log File is switched.
AUX001I COMMAND VALID
AUX418I LOG SWITCHED FROM LOGX TO LOGY

1-52

1. Monitor Commands

1.3.11 Trace Command (L Command)
Input Pattern
Trace command is related to the settings of trace log that is collected by A-AUTO Monitor.
It may be used to perform the following. (This command is available in version level v6010 or later) Display the output level of trace log.
 Dynamically change the output level of trace log.
 Dynamically change the output level of trace dump.
 Dump the content of queue buffer to a file.
 Forced switch the current trace log file.

1-53

1. Monitor Commands■ Display Trace Log Output Level(1) Function
Display current output level of the trace log of A-AUTO Monitor.

(2) Command Input
l｛Type｝<1><1>Type

Example1-32:

Select the display type from the following options.
trace: Display the trace output level for each task.

dump: Display dump output level.

Display trace level
Enter the following command to display the current output level of the trace log.
ltraceWhen A-AUTO Monitor receives this command, the following messages will be displayed. It displays theoutput level of the trace log for each task.
AUX001I COMMAND VALID
AUX047I TRACE LEVEL FOR MCP
IS 3
AUX047I TRACE LEVEL FOR NCP
IS 3
AUX047I TRACE LEVEL FOR NJP
IS 3
AUX047I TRACE LEVEL FOR NEP
IS 3
AUX047I TRACE LEVEL FOR TMR
IS 3
AUX047I TRACE LEVEL FOR EXECSCR IS 3
AUX047I TRACE LEVEL FOR CIP
IS 3

1-54

1. Monitor Commands■ Change Trace Log Output Level(1) Function
Dynamically change the output level of the trace log.
Except for tasks execscr and tmr, the change to the output level of the trace log will be effective
immediately after the command is issued.
For task execscr, the change will be effective for the new instances of the task initiated after the input
command is accepted.
(The output level of the trace log for instances of execscr that are currently running when you issue thiscommand will not be changed.)
For task tmr, the change will be effective when tmr is next invoked by timer interval after you issued thiscommand.

(2) Command Input
ltrace,level=output level[ , TASK=task name ]<1><2><1>Output level:

Specify the output level.
The value that can be specified is different for Windows and for UNIX.

In the case of A-AUTO for UNIX
0 : Only get console messages
1 : Only get trace log for error handling.
2 : Get trace log for all error handling and some normal trace log.
3 : Get all trace log.
In the case of A-AUTO for Windows
0 : Only get console messages
1 : Only get console message (same with 0)
2 : :Get all trace log*You cannot specify 3 for A-AUTO for Windows.

1-55

1. Monitor Commands<2>task Name

: Specify the task which you want to change the trace log.
all

:Change all of the tasks

mcp: Change mcp task only

ncp

: Change ncp task onlynep

: Change nep task only

njp

: Change njp task only

execscr : Change execscr task only
tmr

: Change tmr task only

cip

: Change cip task only

1-56

1. Monitor Commands

Example1-33

Change trace log getting level
Change output level of trace log for all tasks by entering the following command.
ltrace,level=3,task=all
When A-AUTO Monitor receives this command, the following messages will be displayed. It displays thecurrent output level of trace log.
AUX001I COMMAND VALID
AUX046I LEVEL COMMAND IS ACCEPTED
AUX036I MCP RESET TRACE LEVEL TO 3 SUCCESSFULLY
AUX036I NJP RESET TRACE LEVEL TO 3 SUCCESSFULLY
AUX036I NCP RESET TRACE LEVEL TO 3 SUCCESSFULLY
AUX036I EXECSCR RESET TRACE LEVEL TO 3 SUCCESSFULLY
AUX036I CIP RESET TRACE LEVEL TO 3 SUCCESSFULLY
AUX036I NEP RESET TRACE LEVEL TO 3 SUCCESSFULLY
AUX036I TMR RESET TRACE LEVEL TO 3 SUCCESSFULLY

1-57

1. Monitor Commands■ Change of Dump Log Output Level(1) Function
Dynamically change the output level of the dump log.

(2) Command Input
ldump,level= Output level<1><1>Output level

Example1-34:

Specify the output level.
0: Do not get dump log

1: Only get dump log for error handling2: Get dump log for all error handling and some normal dump log.

3

: Get all dump log

Change of dump log getting level
Change output level of dump log by entering the following command.
ldump,level=1
When A-AUTO Monitor receives this command, the following message will be displayed. It displays thecurrent output level for dump log.
AUX001I COMMAND VALID
AUX046I LEVEL COMMAND IS ACCEPTED
AUX037I MCP RESET DUMP LEVEL TO 1 SUCCESSFULLY
AUX037I NJP RESET DUMP LEVEL TO 1 SUCCESSFULLY
AUX037I EXECSCR RESET DUMP LEVEL TO 1 SUCCESSFULLY
AUX037I NCP RESET DUMP LEVEL TO 1 SUCCESSFULLY
AUX037I NEP RESET DUMP LEVEL TO 1 SUCCESSFULLY
AUX037I CIP RESET DUMP LEVEL TO 1 SUCCESSFULLY
AUX037I TMR RESET DUMP LEVEL TO 1 SUCCESSFULLYNote
You cannot change the output level of dump log at task level.

1-58

1. Monitor Commands■ Output Queue Buffer Dump
(1) Function
Output the content of queue buffer in memory to a file.

(2) Command Input
ldump,queue(3) Output
Create a dump of queue buffer to a file with the following file name and to be stored in LOG directory.
File name:QBUFFDUMP_yyyymmddhhmmss.log(Example:QBUFFDUMP_20050509151614.log)

If the file name already exists, it deletes the existing file and create a new file by using this file name.
Example1-35

Output queue buffer dump
Output the content of queue buffer in memory to a file by entering the following command.
ldump,queue
When A-AUTO Monitor receives this command, the following messages will be displayed. It output thecontent of queue buffer in memory to a file.
AUX001I COMMAND VALID
AUX040I STARTED TO DUMP NETWORK QUEUE BUFFER
AUX041I QUEUE BUFFER DUMP IN PROGRESS ... (500/2000)
AUX041I QUEUE BUFFER DUMP IN PROGRESS ... (1000/2000)
AUX041I QUEUE BUFFER DUMP IN PROGRESS ... (1500/2000)
AUX041I QUEUE BUFFER DUMP IN PROGRESS ... (2000/2000)
AUX042I COMPLETED TO DUMP NETWORK QUEUE BUFFER
AUX039I NETWORK QUEUE DUMP COMPLETED SUCCESSFULLY* Message code “AUX041I” will be displayed for every 500 records (lines) of queue buffer dump.

1-59

1. Monitor Commands

e.g.1-36

Output queue buffer dump:::
Network ID
20050207 121241 NCP: Q-BUFFER[19]-------Schedule Date
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0123456789ABCDEF
000000 32 30 30 35 30 32 30 37 41 06 4F 4C 54 4D 31 32 20050207A.OLTM12000010 20 20 00 00 00 4E 80 80 20 02 BA DC...N.. ...
Priority
20050207 121241 NCP: Q-BUFFER-EX[19]-----Class00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0123456789ABCDEF
000000 55 4E 49 58 30 31 20 20 4F 4C 54 4D 31 31 20 20 UNIX01 OLTM11000010 4F 4C 54 4D 31 42 20 20 4F 4C 54 4D 31 43 20 20 OLTM1B OLTM1C
000020 53 4B 44 53 30 34 20 20 58 4D 41 44 30 34 20 20 SKDS04 XMAD04
System
000030 58 4D 4B 48 30 34 20 20 00 00
00 00Qualifier
00 00 00 00 XMKH04 ........
000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
Network
000060 00 00 00 00 00 00 00 00 00Preceding
00 00 00 00
00 00 ID
00 ................
000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
000080 00 00 00 00 00 00 00 00 00 00 00 13............
20050207 121241 NCP: QBUFF[20]------00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0123456789ABCDEF
000000 32 30 30 35 30 32 30 37 41 06 4F 4C 54 4D 31 33 20050207A.OLTM13000010 20 20 02 00 00 4E 00 00 20 02 BB 68...N.. ..h
:
:
:
:

Note
When processing the Output Queue Buffer Dump Command, load of A-AUTO Monitor will be high, so do
not use this command except when fixing bugs.

1-60

1. Monitor Commands■ Trace Log Switch Command(1) Function
Trace log is saved to two files named X and Y interchangeably. In general, when one file is full, A-AUTO
Monitor will automatically switch to the other file to save the trace log.

Trace Log Switch Command isused to manually switch of the trace log file. When A-AUTO Monitor receives this command, these two files
will be switched (X to Y or Y to X) immediately.

(2) Command Input
lswitchExample1-37

Switch trace log
When A-AUTO Monitor receives this command, the following message will be displayed. It switches log
files accordingly.
AUX001I COMMAND VALID
LGC200I 2005/04/09 15:52:49 SWITCH LOG(XCTraceLog)
AUX038I TRACELOG FILE SWITCHED SUCCESSFULLY

1-61

1. Monitor Commands

1.3.12 Parameter Display Command(1) Function
Display contents of the system parameters of running A-AUTO Monitor on the console.

(2) Command Input
lparm

Note


Some parameters may not be displayed. For these parameters, please get their settings inenvironment variables or input DA,ALL command.

e.g.1-38

Parameter Display
When A-AUTO Monitor receives this command, the following messages will be displayed.
AUX001I COMMAND VALID
AUX120I *** PARAMETER DISPLAY ***AUX122I AUTO_VER= V3
MONITORKIND=SAUX122I AUTO_TMITVLON=0
AUTO_REREON=0
AUX122I AUTO_RESON=1
AUTO_AMLINKON=0
AUX122I AUTO_TLOG_BACKUP=0
AUTO_TLOG_MAXLINE= 50000
AUX122I AUTOR3_WITHSAPR3=0
MESSAGES_AUTOPROC= AUTO01
AUX122I MESSAGES_MSID= 7000MESSAGES_CIPMSID= 350
AUX122I MESSAGES_WAITTIME=0MSGLOG_MAXTIME=0
AUX122I MCP_MAXTMRQ= 400
MCP_MAXDELAYBAT=0
AUX122I NCP_MAXNWKQUE= 320
NCP_HOLDQUEUEWARM=0
AUX122I NCP_SEARCHTIME_CHECK=0
NCP_SEARCH_MAXSTART= 255
AUX122I NCP_USE_OLDESTDATE=0
NCP_SAMENET_INQUE=0
AUX122I NCP_SENDNEND_AT_FREEON = 1
NCP_CARRYONQUE=1
AUX122I NJP_JOBLOGON=0
NJP_REMON=1
AUX122I NJP_PARAON=1
NJP_JPON=0
AUX122I NJP_JOBNAMEON=1
NJP_CONNRETRY= 200
AUX122I NJP_CONNINTERVAL=1
NJP_KEEPALIVE_TMR=0
AUX122I NJP_KEEPALIVE_RMT=0
NJP_MONITORDOWN_CANCEL = 0
AUX122I TMR_TIMER_INTERVAL= 30
CIP_TIMEOUT_SEC= 60
AUX122I ASV_CORRESPOND=0
ASV_AGENTNAME=
AUX122I AUTO_ASV_SRCFNAME= NWKSTKMAX_USERS= 1000
AUX122I AUTO_RJOB_RCVY=0
AUTO_SESS_RCVY=0
AUX122I NCP_NTWK_STOP=0
AUX121I *** END OF PARAMETER DISPLAY ***1-62

1. Monitor Commands

1.3.13 Monitor On Command (M Command)(1) Function
This command is used to set on or off the Monitor On wait condition of a Network that has Data Wait
attribute.

In normal situation, the succeeding Networks of a Network that has Data Wait attribute will beplaced in Monitor On wait condition. Issuing Monitor On command to this Network will release its
succeeding Networks for execution by releasing the Monitor On wait condition.

(2) Command Input
m Network[,Type][,sdate=Date]<1> <2><3><1>Network:

Specify the Network which has Data Input Wait attribute.

<2>Type:

Specify whether to Monitor On or Off the Network of <1>. (Default: on)
on :Monitor ON
off :Monitor OFF<3>Date:Specify the Schedule Date of the Network of <1> in the format of yyyymmdd
or yymmdd (Default: Operation Date)* <2>Type] must be specified immediately after [<1> Network.
Note

e.g.1-39

Please issue Monitor Command after the Network which has Data Input Wait attribute has ended.

Monitor on Network
Monitor On ANET0001 (Network).
manet0001,on,sdate＝040120

When A-AUTO Monitor receives this command, the following messages will be displayed. Monitor On wait
condition of the Network will be released.
AUX001I COMMAND VALID
AUX762I NETWORK ANET0001 SDATE=2004/01/12 IS MONITORED ON

1-63

1. Monitor Commands

Example1-40

Monitor off Network
Monitor Off ANET0001 (Network)
manet0001,off,sdate=040120
When A-AUTO Monitor receives this command, the following messages will be displayed. Monitor On wait
condition of the Network is set on.
AUX001I COMMAND VALID
AUX762I NETWORK ANET0001 SDATE=2004/01/12 IS MONITORED OFF

1-64

1. Monitor Commands

1.3.14 Stop Command (P Command)(1) Function
Stop command is used to temporarily suspend a Network that is executing. You can resume theexecution of the Network by using Go Command.

(2) Command Input
pNetwork<1><1>Network:

The Network which you want to suspend.

Note

When A-AUTO MONITOR accepts the P command, it stops submitting the remaining jobs in the
Network for execution. It allows the active jobs in the Network to complete their execution.

This command must be issued to an executing Network in A-AUTO MONITOR. If it is issued to a
Network that is not executing, message AUX413I is displayed and the command is ignored.



e.g.1-41

Although the network is suspended and not executing, the Network still occupies the NP partition.

Network Pause
Stop ANET0001 (Network) temporarily.
panet0001
When A-AUTO Monitor receives this command, the following messages will be displayed. ANET0001 will
be suspended temporarily.
AUX001I COMMAND VALID
AUX413I NETWORK ANET0001 SDATE=2004/01/12 WILL STOP SOON

1-65

1. Monitor Commands

1.3.15 Start Command (S Command)(1) Function

Start command may be used to perform the following: To execute again a Network that has normally ended under A-AUTO Monitor.
 To rerun a Network that has abnormally ended under A-AUTO Monitor. (Rerun type) To execute a Network that is not in the Queue.
(2) Command Input
sNetwork[,Attribute][,Job specification][,sdate＝Date]
<1>

<2>

<3>

<4>

<1>Network:

Specify the Network which you want to execute.

<2>Attribute:

If you want to specify attribute(s) for the Network of <1>, and select the
attributes from the following options.
Time=time:

Specify a start time for the Network of <1>. The
format of time is hhmm.

Prty=priority:

If you want to change the priority for the Networkof <1>, please specify this option.
If you do not specify this option, the default valueof prty is 8.
(01<=Priority<=15)class=class:

If you want to change the Execution Class for the
Network of <1>.

Joblib=Job Library ID: If you want to specify the Job Library ID for the
Network of <1>.

1-66

1. Monitor Commands<3>Job specification:

Select a Job or a range of Jobs from the Network of <1> to execute. You
can select Job(s) by one of the following options.
f=Job: Execute the Network starting from this Job

t=Job: Execute the Network starting from the first Job to this Job

o=Job : Only execute this Job
e=Job : Execute all job(s) of the Network except this Job
b=(From Job, To Job)
: Execute the Job(s) in the range you specified<4>Date:Specify Schedule Date of Network of <1> in the format of yyyymmdd or
yymmdd (Default: Operation Date)

Note

When you enter the command using batch method and you want to specify Job specification
parameters <3>, you will need to enter the command enclosed in ’ ‘ as follows.
cip ’sNetwork, Job specification’

The Job which is specified in Job specification of parameter <3> will be executed according to the
Job configuration of the specified Network registered in the Network Master.



You cannot issue Start command for a Network if the Network Queue already has an existing
Network with same Network ID and Schedule Date. If you specify such a Network, the error message"AUX803I" will be displayed and the command will be ignored. .

You cannot issue Start command for a Network if A-AUTO Monitor is currently executing a Networkwith same Network ID and Schedule Date. If you specify such a Network, the error message"AUX848I" will be displayed and the command will be ignored.

You cannot issue the command for a Network that is not defined in Network Master. If you specify
such a Network, the error message "AUX804I" will be displayed and the command will be ignored.

Networks will be executed in the input order of the Start commands if they have no preceding
Networks executing or in Network Queue. If you want to Start several Networks and these Networks
have preceding relation among themselves, you need to be aware of the order when you input theStart commands.

1-67

1. Monitor Commands

In the case of starting a Network,

the attribute information for the Network is obtained as follows.

<1>If the specified Network has been abnormally ended,
it will refer to Abnormally Terminated Network File.
<2>If the specified Network is not in Abnormally Terminated Network File.
It will search for the Network information in these files in the following order: Daily Network
Master →Network Master. It refers to the Master information of the first file with the Network
information.


If you did not specify the prty attribute in the Start command, the priority of the started Network willbe 8 regardless of the priority which you defined in Network Master. Default value of priority is 6 when
you register a Network in Network Master. If this Network is started by Start command without prty
attribute, the priority of the Network assigned is therefore higher. If you want to add this Network to
the Queue with the same priority as defined in the Master using Start Command, then prty attributemust be specified.

When a Network is started by A-AUTO for OS/400 Remote License or R/3 Job is included in thisNetwork, you cannot set a value out of 0 for it. If you set, an error message will be displayed, andterminate this command. If the Network to be started is for execution in A-Remote for OS/400 or the
Network contains R/3 jobs, Job Library ID can specify a value of 0 only. If a value other than 0 is
specified, a message will be displayed and the processing of the command is terminated.



If you did not specify Job Library ID, Job Library ID will be set as follows.
<1>If the specified Network has been abnormally ended,
it will refer to Abnormally Terminated Network File.
<2>If the specified Network is not in Abnormally Terminated Network File, set 0 for it.



If you only specify recovery Job for Job specification option, the Job will not be executed even thoughStart Command is executed successfully.

1-68

1. Monitor Commands

Example1-42

Start Network
Start ANET0001 (Network) for execution on A-AUTO Monitor.
sanet0001
When A-AUTO Monitor receives this command, the following messages will be displayed. ANET0001 will
be executed.
AUX001I COMMAND VALID
AUX824I NETWORK ANET0001 SDATE=2004/01/12 START ACKNOWLEDGED

e.g.1-43

Start Network (Set Start Time )Start ANET0001 (Network) with Start Time set to 11:00 to be executed on A-AUTO Monitor.
sanet0001,time=1100
When A-AUTO Monitor receives this command, the following messages will be displayed. ANET0001 will
be executed.
AUX001I COMMAND VALID
AUX824I NETWORK ANET0001 SDATE=2004/01/12 START ACKNOWLEDGED

Example1-44

Start Network (Set Job Name 1)
Only JOB01 of ANET0001 (Network) is to be executed on A-AUTO Monitor.
sanet0001,o=job01
When A-AUTO Monitor receives this command, the following messages will be displayed. Only JOB01 of
ANET0001 will be executed.
AUX001I COMMAND VALID
AUX824I NETWORK ANET0001 SDATE=2004/01/12 START ACKNOWLEDGED

Example1-45

Start Network(Set Job Name 2)
The range of Jobs from JOB01 to JOB06 of ANET0001 (Network) is to be executed on A-AUTO Monitor.
‘ sanet0001,b=(job01,job06)’
When A-AUTO Monitor receives this command, the following messages will be displayed. Jobs JOB01 to
JOB06 of ANET0001 will be executed.
AUX001I COMMAND VALID
AUX824I NETWORK ANET0001 SDATE=2004/01/12 START ACKNOWLEDGED

1-69

1. Monitor Commands

1.3.16 Tom Command (T Command)(1) Function
Tom Command is used todisplay the content of Abnormally Terminated Network File or to delete

information of abnormally ended Network.
(2) Command Input
tNetwork[,SDATE＝Date][,free＝y][,Type]
<1>

<2>

<3>

<4>

<1>Network:

Specify the Network which you want to display or delete (Specify in <4>).

<2>Date:Specify the Schedule Date of the specified Network in the format ofyyyymmdd or yymmdd (Default: Operation Date)<3>free=y:When you want to delete information of abnormally ended Network (Specifyin <4>) and at the same time Free On the Network of <1>.

<4>Type:

Display or delete.

c:Delete the Network of <1> from Abnormally Terminated Network File.

d:

Display the Network of <1> from Abnormally Terminated Network File.
(Default: d).

Note

If a Network that is to be added to Queue by Start Command or Queuing Command exists in
Abnormally Terminated Network File, this Network will be executed as Rerun type and its preceding
relation is ignored.



If the Network information is first deleted from Abnormally Terminated Network File and the Networkis then added by Start Command. This Network will be executed as Normal type. In this case, thepreceding relation of the Network is valid.



If you perform Tom Clear (delete information of abnormally ended Network) after adding the Network
to the Queue as Rerun type but before the Network starts execution, the following message will be
displayed and the Network cannot be started.
“AUX604I NETWORK Network ID SDATE=xxxxxxxx NOT FOUND IN NETWORK TOM FILE”

1-701. Monitor Commands

Example1-46

Display ABEND Network
Display the information of ANET0001 (Network) in Abnormally Terminated Network File.
tanet0001,SDATE=111130,dWhen A-AUTO Monitor receives this command, the following information of ANET0001 (Network) will be
displayed.
AUX001I COMMAND VALID
AUX733I *** DISPLAY NETWORK TOM *** TIME=21-12-41
AUX734I NETWORK ANET0001 SDATE=2011/11/30 EXECUTED DATE=2011-11-30(21-08-15)
AUX735I JOB# JOBNAME STT RST RC REASON
USER-ID
AUX736I 010 ANET01
80 00 00 JOB TERMINATE
AUTOUSER
AUX736I 020 ANET02
80 00 12 JOB ABENDED
ADMIN
AUX737I *** END OF NETWORK TOM DISPLAY ***e.g.1-47

Delete Information of Network in Abnormally Terminated Network File
Delete ANET0001 (Network) from Abnormally Terminated Network File.
tanet0001,SDATE=111130,c
When A-AUTO Monitor receives this command, the following messages will be displayed. The informationof ANET001 will be deleted from Abnormally Terminated Network File.
AUX001I COMMAND VALID
AUX740I NETWORK ANET0001 SDATE=2011/11/30 HAS CLEARED FROM NETWORK TOM FILE

1-71

1. Monitor Commands

1.3.17 Timer Command (X Command)(1) Function
Timer Command is used to display the content of Timer Queue or re-create Timer Queue. Timer Queuecontains information of Networks that have Input Data Wait and/or Start Time Wait conditions.

(2) Command Input
x[r]
<1>
<1>ｒ

:

Specify this if Timer Queue is to be re-created.
(Default: Display content of Timer Queue (waiting status))e.g. 1-48

Display the content of Timer Queue
Display the content of Timer Queue.
xWhen A-AUTO Monitor receives this command, the content of Timer Queue will be displayed.
AUX001I COMMAND VALID
AUX714I *** TIMER QUEUE MEMORY LIST *** TIME=10:58:57
AUX715I NETWORK ATTRIBUTE STATUS
START-TIME SCHEDULE-DATE
AUX717I ANET0001 INPUT( )0000
2004/01/12
AUX717I BNET0001 TIME
( )0900
2004/05/20
AUX717I BSPSTA
INPUT
( )
0000
2004/05/20
AUX717I CNET01
INPUT
( )
0000
2004/05/20
AUX717I OLTM01
TIME
( )
1130
2004/05/20

Example 1-49

Re-create Timer Queue

Re-create Timer Queue.
xr
When A-AUTO Monitor receives this command, the following messages will be displayed. The Timer
Queue is re-created.
AUX001I COMMAND VALID
AUX839I TIMER QUEUE BUFFER REBUILD COMPLETED, TOTAL 40

1-72

1. Monitor Commands

1.3.18 Queue Search Command (XQ Command)(1) Function
Queue Search Command is used to optimize the execution order of the Networks in the Queue.

(2) Command Input
xq
Note


Please issue XQ Command for Networks which have been added to the Queue, when you havecreated record for the Networks by chkd utility.

e.g.1-50

Queue Search Running
Perform Queue Search.
xq
When A-AUTO Monitor receives this command, the following messages will be displayed. Queue Search
will be performed.
AUX001I COMMAND VALID
AUX885I SEARCHING EXECUTABLE NETWORKS IN QUEUE ENDED

1-73

1. Monitor Commands

1.3.19 Help Command (DH Command)(1) Function
This command is used for displaying the help information for Monitor Commands.

(2) Command Input
dh[,Command name]<1><1>Command name:Specify the name of Monitor Command for which you want to display thehelp.
If you do not specify it, the list of Monitor Commands will be displayed.
Specify a Command from this list.

Note

Output of this command will be displayed on the console but will not be written to log file (except
AUX001I message).

e.g.1-51

Display help of Monitor Command
Display help of Release Command.
dh, AWhen A-AUTO Monitor receives this command, the following messages will be displayed. The help of"Release the specified Network" Command will be displayed.
AUX001I COMMAND VALID
Release a Network in hold status.
a Network [,sdate=Date]
Network
DateSpecify Network ID to be released
Specify the schedule date of Network to be released in yyyymmdd
format or yymmdd format (default : operation date)

1-74

2. A-AUTO/Agent & A-AUTO/AP Server Commands(3) When an interface to Windows® is defined■ Methods to issue commands on Windows
Issuing commands to AP-LINK on Windows
Methods to issue commands
Start Command Prompt and then switch to A-AUTO installation directory. You may now use icom to issuecommands from the Command Prompt console.
* The default A-AUTO installation directory is C:\BSP\AUW\BIN/
icom∆XX ∆command* XX is APLINK-ID.
* The default APLINK-ID of A-AUTO/Agent is 01.

Issuing commands in resident mode
icom∆01
CommandIssuing commands in direct mode
icom∆01∆command

2-8

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ v, c, n Command
Removes a Network from monitoring target① Function
This command removes the specified Network from the monitoring target list of Delay Monitor.

② Input format

icom∆XX∆v,c,n= Network Name

* Specify APLINK-ID for XX. The default value is 01.
* For detailed information, please refer to “2.1.1 Commands used by Agent” and “■Methods to issuecommands on Windows”.
Note

The change to Network Delay Monitor information specified in this command is not reflected (updated)
in Network Delay Monitor File.

The Network Delay Monitor information set by this command remains valid until either when thespecified Agent is restarted or when v, restartd command is issued.
Thesettings

inthe

Network

Delay

Monitorfiledefinedby

FSTFILEinregistry,\\HKEY_LOCAL_MACHINE\SOFTWARE\BSP\A-AUTOforWindowsNT\2.0\ASVSYSPARM\DELAY,
become effective when either the Agent is restarted or v, restartd command is issued.

2-9

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ v, e, n Command
Changes Estimate Start Time and Estimate End Time of Network① Function
This command changes the Estimate Start Time and/or Estimate End Time of the specified Network. A
Network is regarded as delayed if it does not start or does not end by the specified Estimate Start Time or
Estimate End Time.

② Input format
icom∆XX∆v,e,n= Network Name［, s=Estimate Start Time］［, e=Estimate End Time］

Estimate Start Time・Estimate End Time
Specify the time in hhmm format. The value must be 0000 to 4759.
Either or both Estimate Start Time and Estimate End Time can be specified.
* Specify APLINK-ID for XX. The default value is 01.
* For detailed information, please refer to “2.1.1 Commands used by Agent” and “■Methods to issuecommands on Windows”.
Note

The change to Network Delay Monitor information specified in this command is not reflected (updated)
in Network Delay Monitor file.



The Network Delay Monitor information set by this command remains valid until either when thespecified Agent is restarted or when v, restartd command is issued.
Thesettings

inthe

Network

Delay

Monitorfiledefinedby

FSTFILEinregistry,\\HKEY_LOCAL_MACHINE\SOFTWARE\BSP\A-AUTOforWindowsNT\2.0\ASVSYSPARM\DELAY,
become effective when either the Agent is restarted or v, restartd command is issued.

2-10

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ v, e, f Command
Refreshes NetworkDelay Monitor File
① Function
This command refreshes the Network Delay Monitor file (asv_dlytbl??) that Delay Monitor task refers to.

② Input format

icom∆XX∆v,

e,f=File number

File number This is the suffix for the Network Delay Monitor file name to be used for refreshing Network
Delay Monitor information. The file number must be between 00 and 99.
※In the case of A-AUTO for Windows version later than V710, Network Delay Monitor information isretrieved from Master data if used in stand-alone mode.
The file number must be 00 in this case.
* Specify APLINK-ID for XX. The default value is 01.
* For detailed information, please refer to “2.1.1 Commands used by Agent” and “■Methods to issuecommands on Windows”.
Note

The setting specified in this command is not reflected (updated) in the registry.



The Network Delay Monitor information set by this command remains valid until either when thespecified Agent is restarted or when v, restartd command is issued. Network Delay Monitor file definedby FSTFILE in registry,\\HKEY_LOCAL_MACHINE\SOFTWARE\BSP\A-AUTOforWindowsNT\2.0\ASVSYSPARM\DELAY isreferred to when the Agent is restarted or when v, restartd command is issued.

* For V710 or later, the parameter FSTFILE is defined in DELAYWATCH section of auto_sysconf file.

2-11

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ v, e, i Command
Changes the Time Interval for Delay Monitoring① Function
This command changes the time interval to monitor delay.

② Input format

icom∆XX∆v,e,

i= timeTime
Specify the time interval in minutes.
* Specify APLINK-ID for XX. The default value is 01.
* For detailed information, please refer to “2.1.1 Commands used by Agent” and “■Methods to issuecommands on Windows”.
Note

The setting specified in this command is not reflected (updated) in the registry.



The Network Delay Monitor information set by this command remains valid until either when thespecified Agent is restarted or when v, restartd command is issued. The setting defined by INTERVAL
in registry\\HKEY_LOCAL_MACHINE\SOFTWARE\BSP\A-AUTOforWindowsNT\2.0\ASVSYSPARM\DELAY,
becomes effective when the Agent is restarted or when v, restartd command is issued.

2-12

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ v, restartd Command
Restarts Delay Monitor Task
① Function
This command restarts Delay Monitor task. When restarted, Delay Monitor task reloads the following file.
 The Network Delay Monitor file that is defined by FSTFILE of registry\\HKEY_LOCAL_MACHINE\SOFTWARE\BSP\A-AUTOforWindowsNT\2.0\ASVSYSPARM\DEL
AYThis command is used in the following situations.
 Failed to start Delay Monitor task due to setting definition error in either FSTFILE of\\HKEY_LOCAL_MACHINE\SOFTWARE\BSP\A-AUTOforWindowsNT\2.0\ASVSYSPARM\DEL
AY or Network Delay Monitor file（SVX106I message is displayed）→
Modify the settings in either FSTFILE
of \\HKEY_LOCAL_MACHINE\SOFTWARE\BSP\A-AUTOforWindowsNT\2.0\ASVSYSPARM\DELAY or Network Delay Monitor file and then issue v, restartd
command.
 Need to revert the settings to default values after v, c, n command,v, e, n command,v, e, fcommand, or v, e, i command is issued→
Issue v, restartd command.

② Input format
icom∆XX∆v, restartd* Specify APLINK-ID for XX. The default value is 01.
* For detailed information, please refer to “2.1.1 Commands used by Agent” and “■Methods to issuecommands on Windows”.
Note
When this command is issued, registry information and Network Delay Monitor file are reloaded andsettings defined in these files become effective.
Therefore, all modifications made by v, c, n command,v, e, n command,

i command before v, restartd command was issued become invalid.

2-13v, e, f command,

and/or v, e,

2. A-AUTO/Agent & A-AUTO/AP Server Commands

2.1.2

Commands for Server■ p, n, conn Command
Connect to Agent① Function
This command connects the server to an Agent.

② Input format
icom∆p,n,① Agent Nameconn,

lb=Agent name①
The name of the Agent to connect toAgent Name to be specified may be up to a maximum of 16 characters③Output Messages
Command input
icom p, n, conn, lb=AGENT01
Output message
APL350I COMMAND (P, N, CONN, LB=AGENT01) IS VALID
APL250I SESSION TO (AGENT01) IS SUCCESSFULLY OPENED

2-14

(00)
(00)

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ p, n, disc Command
Disconnect from Agent① Function
This command disconnects an Agent from the Server.

② Input format(1) Normal disconnection
icom∆p,n,disc, lb=Agent name①

① Agent Name

The name of the Agent to disconnect
Agent Name to be specified may be up to a maximum of 16 characters(2) Forced disconnection
icom∆p,n,① Agent Namedisce,

lb=Agent name①
The name of the Agent to disconnect
Agent Name to be specified may be up to a maximum of 16 characters※ Forced disconnection must be applied only when the Server cannot disconnect from the Agent after
issuing normal disconnection command.

③ Output Messages
Command input
icom p, n, disc, lb=AGENT01
Output message
APL350I COMMAND (P, N, DISC, LB=AGENT01) IS VALID
APL254I SESSION TO (AGENT01) IS SUCCESSFULLY DISCONNECTED
APL262I SESSION TO (AGENT01) IS SUCCESSFULLY CLOSED

2-15

(00)
(00)
(00)

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ p, d, sess Command
To view the information of a session① Function
To display Session information.

② Input format
icom∆p,d,① Agent Name

sess [,

lb=Agent name]①
The name of the Agent for which session information is to be displayed
Agent Name to be specified may be up to a maximum of 16 characters③

Output Messages
Command input
icom p, d, sess, lb=AUTO01
Output message
APL204I AP-LINK V1.5.3 LV02 SESSION INFORMATION
APL350I COMMAND(P, D, SESS, LB=AUTO01) IS VALID
APL206I ID(00) NAME(AUTO01) NODE(VMXP-1)
APL207I STATUS(CONNECT
40) DRIVER(BSPTCPNT) BUFFSIZE(2048)

2-16

(01)
(01)
(01)
(01)

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ FTP Command
File Transfer and Start Monitoring request to agent① Function
This command issues a request to perform File Transfer and Start Monitoring to a specific Agent.

② Input format
icom∆v,

FTP,① Schedule Date

SDATE=yyyymmdd1yyyymmdd2,①

AGT=Agent Name,②

EID=Execution ID③

Specify the period (from schedule date & to schedule date) for File Transfer
operation. Networks and related information for the specified period aretransferred.
yyyymmdd1:Specify from schedule date for File Transfer.

yyyymmdd2:Specify to schedule date for File Transfer.

yyyymmdd2 must be specified even if File Transfer operation is for a single
day.
② Agent Name

The name of the Agent to perform the File Transfer request(Agent Name to be specified may be up to a maximum of 16 characters)③ Execution ID

Specify the Execution ID to be used as a selection criterion for datatransferred by File Transfer. (Numbers 1 to 9, alphabets A to Z and “*” can beused)Omit this parameter if all Execution IDs are to be selected (i.e. do not select by
Execution ID).
* This parameter is valid only for Agents on Mainframe.

③ Output Messages
Command input
icom v, ftp, sdate=2006010120060131, agt=AGENT01
Output message
SVS101I OPERATOR TYPE-IN: ftp, sdate=2006010120060131, agt=AGENT01
SVS111I SEND FTP REQUEST TO AGENT01

2-17

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ STOPFTP Command
Stop File Transfer

Request to an agent① Function
This command issues a request to cancel File Transfer to a specific Agent.
* This command is valid only for Agents on mainframe.

② Input format
icom∆v,

STOPFTP,① Agent Name

AGT=Agent Name①
The agent nameof the Agent whose File Transfer operation is to becancelled.
(Agent Name to be specified may be up to a maximum of 16 characters)③ Output Messages
Command input
icom v, stopftp, agt=AGENT01
Output message
SVS101I OPERATOR TYPE-IN: stopftp, agt=AGENT01
SVS113I SEND INTERRUPT FTP REQUEST TO AGENT01

2-18

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ WATCHEND Command
Request to End Monitoring to a specific Agent① Function
This command issues a request to a specific Agent to stop Event monitoring.

② Input format
icom∆v,

WATCHEND,① Agent Name

AGT=Agent Name①
The name of the Agent whose Event monitoring is to be stopped.
(Agent Name to be specified may be up to a maximum of 16 characters)③

Output Messages
Command input
icom v, watchend, agt=AGENT01
Output message
SVS101I OPERATOR TYPE-IN: watchend, agt= AGENT01
SVS114I SEND WATCH END TO AGENT01

2-19

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ INITFILE Command
Initialization of Monitor File
① Function
This command initializes Monitoring File of A-AUTO/AP Server. This command should not be issued while
File Transfer and monitoring operations in the Agent is in progress.

② Input format
icom∆v, INITFILE③ Output Messages
Command input
Icom v, initfile
Output message
SVS101I OPERATOR TYPE-IN: initfile
SVS121I FILE INITIALIZE START：SVS123I FILE INITIALIZE END

2-20

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ DAGT Command
Agent Information Display① Function
This command displays information about the Agents and their current status.

② Input format
icom∆v,DAGT③ Output Messages
Command input
icom v, dagt
Output message
SVS101I OPERATOR TYPE-IN: dagt
SVS135I *** A-SUPERVISION AGENT STATUS DISPLAY ***SVS136I
AGENT NAMESTUATUSSVS137I
AGENT01
DISCONNECT
SVS137I
AGENT02
CONNECT
SVS137I
AGENT03
FTP RUNNING
SVS137I
AGENT04
WATCHING
SVS137I
AGENT05
FTP RUNNING
SVS139I ***DISPLAY END

2-21

***

2. A-AUTO/Agent & A-AUTO/AP Server Commands■ REPT Command
Replicated Master Synchronization① Function
This command issues a request to synchronize Master data between a specific Agent and Database on
A-AUTO Server (replicate).

② Input format
icom∆v,

REPT,

AGT=Agent Name①

① Agent Name

The name of the Agent whose Master data is to be synchronize.
（Agent Name to be specified may be up to a maximum of 16 characters）③ Output Messages
Command input
icom v, rept, agt=AUTO01
Output message
SVS101I OPERATOR TYPE-IN: REPT, AGT=AUTO01

2-22

4. A-AUTO/Event commands

4 A-AUTO/Event Commands
The following A-AUTO/Event commands are provided for system administrators.
The commands are used mainly when problems occur in the system.
Input command formats differ depending on the platform on which A-AUTO/Event runs.

■ For UNIXicom∆r, command nameExample 4-1

START command
icom r,start■ For Windowsr, command nameExample 4-2

START Commandr, start

4-1

4. A-AUTO/Event commands

4.1

4.1.1

Description of Commands for A-AUTO/Event

A-AUTO/Event Server Commands■ START Command(1) Function
To request Work Monitor to start the monitoring of a specific Group and/or Work unit.

(2) Input Format
R,START[,UID=Group ID ][,NAME=Work ID]①①Group ID②： Specify Group ID
All groups will be monitored if this is not specified.

②Work ID

： Specify Work ID
All Work units defined by the user will be monitored if this is not specified.

4-2

4. A-AUTO/Event commands■ STOP Command(1) Function
To request Work Monitor to end the monitoring of a specific Group and/or Work unit.

(2) Input Format
R,STOP[,UID=Group ID ][,NAME=Work ID]①①Group ID②： Specify Group ID
Monitoring will end for all the groups if this is not specified.

②Work ID

： Specify Work ID
Monitoring will end for all Work units defined by the user if this is not
specified.

4-3

4. A-AUTO/Event commands■ FIREEVENT Command(1) Function
To make a specified Event occurred.

(2) Input Format
R,FIREEVENT,NAME=Event detection information ,TYPE=Event type,①②
SITENAME=Computer
information

name

where

the

event

occurs[,RES=Event③

occurrence④①Event detection information：

Specify Event detection information.

②Event type：Specify Event type
J：Job Event
F：File Event
M：Message Event③Computer name where the Event occurs： Specify the computer name where the Event is expected
to occur.
④Event occurrence information：

Specify the Event occurrence information.

4-4

4. A-AUTO/Event commands■ RELOAD Command(1) Function
Retrieves trace option from XOPENSYS file.

(2) Input Format
R,RELOAD

4-5

4. A-AUTO/Event commands

4.1.2

A-AUTO/Event Agent Commands■ DISP Command(1) Function
Display the list of Events that Agent is monitoring.

(2) Input Format
R,DISP

4-6

4. A-AUTO/Event commands■ ADDEVENT Command(1) Function
Request Event Monitor to add an event.

(2) Input Format
R,ADDEVENT,NAME=Event detection information ,TYPE=Event type①②①

Event detection information ： Specify Event detection information.

②

Event type：Specify Event type.
J：Job Event
F：File Event
M：Message Event

4-7

4. A-AUTO/Event commands■ DELEVENTCommand(1) Function
Request Event Monitor to remove an event.

(2) Input Format
R, DELEVENT,NAME=Event detection information,TYPE=Event type①②

① Event detection information：

Specify Event detection information.

② Event typeSpecify Event type.

：

J：Job Event
F：File Event
M：Message Event

4-8

4. A-AUTO/Event commands■ RESET command(1) Function
Stop All Event Monitor.

(2) Input Format
R,RESET

4-9

4. A-AUTO/Event commands■ RELOAD Command(1) Function
Trace Option Reload from XOPENSYS file.

(2) Input Format
R,RELOAD

4-10

5. Support Utilities

5. Support Utilities
Unless specifically stated in the description for each utility, support utilities are performed in the environment where the
A-AUTO monitor resides.

■ abasctl utility
Manage and control ABASINIT(1) Function
It provides the following functions to manage and control the ABASINIT.
・Terminates ABASINIT
・Lists Shared Memory managed by ABASINIT
・Removes an entry in the Shared Memory managed by ABASINIT
abasctlabasinit

Shared Memory

Note
When terminating ABASINIT, ensure that the A-AUTO monitor and other BSP products are not active.

(2) Command Input
Abasctl∆Type [∆KeyWord]<1><1> Type:<2>
Please specify one of the following command types.
close

:

Terminate ABASINIT

listmem:

List the shared memories managed by ABASINIT.

remmem: Remove an entry in the shared memory managed by ABASINIT.
Specify the ID of the shared memory in Keyword option.

<2> Keyword :When specifying remmem as Type, ID of the shared memory to be removed is specified.
You can obtain the ID of shared memory by using listmem type.

5-1

5. Support Utilities

e.g. 5-1

abasctl listmem Execution Example$ abasctl listmem== ABASINIT SHARED MEMORY LIST < 8 RECORD > ===-----+------------+------------+----------+----------+----------No | ID
| ADDRESS| SIZE| OWNER| USER-----+------------+------------+----------+----------+----------001 | A8100161 | 0x40000010 |328 | 1384514 | b1266
002 | APLINK38 | 0x20004910 |
3260 | 1777822 | b1303
003 | BSPCON38 | 0x001B209E |4 | 1777822 | b1303
004 | APLINK39 | 0x20004910 |
3476 | 1048746 | b1303
005 | A1138001 | 0x30000010 |
16556 | 1777822 | b1303
006 | BSPCON39 | 0x001000AA |4 | 1048746 | b1303
007 | A1139001 | 0x30000010 |
16556 | 1048746 | b1303
008 | A81004F1 | 0x40000010 |328 | 909512 | b6003-----+------------+------------+----------+----------+-----------

e.g. 5-2

abasctl remmem Execution Example$ abasctl remmem A8100161
Remove key(A8100161)'s vector table(s) (y/n) ? y
REMMEM command successfull. ID(A8100161).

5-2

5. Support Utilities■ aexit utility
Set job return code
・Only the Windows version supports function.
(1) Function
An aexit utility is a utility to set return code of a batch job.
Include this utility into a job (batch file) and use it to set return code just before exiting the batch.
When the value specified for aexit is not between 0 and 255, it is treated as an abnormal end value and avalue of 255 is set.
In Windows NT, the return code of a job is unknown. Therefore, this utility must be used.
In Windows2000 or later, as a numerical value can be returned by the exit command (MS-DOS command), it
is not necessary to use aexit.
However, please take note the following.
Exit code of a job accepted by A-AUTO for Windows must be between 0 and 255. Therefore, if a value
outside the range is returned by the exit command, A-AUTO for Windows may not be able to recognize thereturn code correctly.
To prevent this problem, it is recommended to use aexit utility even for Windows 2000 or later. This isbecause aexit utility will reset the return code value to 255 if the value specified is outside the range.
* The maximum value of the return code is 127.

(2) Command Input
aexit∆Return Code<1>
<1> Return Code: 0-255.

Example@echo off
if exist .\test.dat goto :OK
goto :NG:OKecho OK
aexit 0exit
:NGecho NGaexit 10exit

5-3

5. Support Utilities■ autosmod utility
Change Schedule(1) Function
autosmod utility can be used to change schedules generated by autosche or remakesche utility.
The Schedule Master created by autosche or the remakesche utility and the contents of Daily Network
Master are directly adjusted accordingly.
The contents of Daily Network Master after adjustment are output to a list. The following functions areavailable in autosmod utility.

●Add Schedule Date
●Move Schedule Date
●Change daily network information●Cancellation of the schedule (Delete)●Set Start Delay Time
●Set End Delay Time
●Set Time Interval End Time
●Set Start Time Interval●Set Plug-in Parameter before Start●Set Plug-in ID after start●Set Network Max Executing Time

(2) Command Input
Autosmod [∆Card File Name ] [∆List Format ]<1><2><1> Card File Name:

This is the file name of the card file which autosmod uses. (Required)This card file must be stored in the directory specified in environment variable

FILES_PATH, in the case of Windows, and AUX_FILES_PATH, in the case of UNIX.
<2> List Format:

Select the format for output list
F: A Daily Network Master summary list and a Daily Network Master detailed list
are output. (Default)
L: A Daily Network Master detailed list is output.

5-17

5. Support Utilities(3) Card File
There are 3 card types, card type 0 to 2, that can be specified for the card file used by the utilityThe card types tobe specified depends on the autosmod functions (Add / Modify / Delete) requested as shown below.

Add

Modify(Move)

DeleteCard Type 0

⊚

⊚

⊚

Card Type 1

○

○

×

Card Type 2

×

○

×

⊚ Required ○When necessary ×Not to be specified
Each card type consists of a common section and a data section.
Starting from column 1, the first five columns is common section and Column 6 onwards is the data section.

Items to be specified in the common section
No.

Item

Colu

Size

Type

Explanation

1

LetterSpecify "F".(Required)mn
A1

Information

1classification

A2

Processing(fixed)2

1Letter

Select one of the following

Typeprocessing types. (Required)
A: AddU: Modify(Move)
D: Delete

A3

Card NO

3

3

NumberSpecify a card number between 001 and 999.

A setof cards consisting of different card types may berequired to perform a specific function.

Cards

belonging to a set must have the same card number.
Different card number for different functions must be
assigned in ascending order.

Items to be specified in the data section
Items to be specified vary according to the processing types.

5-18

5. Support Utilities

Card Type 0
No.

Item

Colu

Size Type

Explanation

-

-

-

Refer to common part

6

1

Numb

Specify " 0".(Required)mn
CommonPart
B1

Card IDer(Fixed)B2

Network

7

Name

1~

LetterWhen "U" or "D" is specified as processing type (A2), you can

8, Signspecify the prefix network name. For prefix name, append "*"at the end of the partial Network name. It is also possible tospecify only "*". If you specify only "*", the processing will
apply to all schedules.

B3

Change171LetterThis item can only be specified for Processing Type “U” (A2).

Type

Specify 'R' in this item if the schedule date of selected
networks is to be moved (rescheduled).

In this case, thetarget schedule date of the selected networks is specified inProcessing Date 1 item (B4) and the new schedule date is
specified in Processing Date 2 item (B5). It must be blank if
not used.
B4

Processin

18

6g Date1
B5

Processing Date2

24

6

Numb

Specify the date in the format yymmdd.

erMust be specified.

Numb

For Processing Type 'U' (A2) with Change Type 'R' (B3), thiseritem specifies the new schedule date for the Networks.

Inother cases, this item is optional and, when specified,indicates the To Schedule Date in range specification.

Forrange specification, the From Schedule Date is specified inProcessing Date 1 (B4).
When left blank, Processing Date 1 item (B4) becomes a
specific schedule date instead of a range specification

5-19

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

1

The value that can be specified is 1 ~ 9, A ~ Z or blank.

mn
B6

Execution

30

L&N

ID

For Processing Type 'D' (A2), this item is used as anadditional criterion for selecting networks for processing.
Only networks having the specified Execution ID are selected
for processing. When left blank, all Execution IDs are
selected.
For Processing Type 'U' (A2) with prefix network namespecified in the Network Name item (B2) and 'R' specified in
the Change Type item (B3), this item is also used as anadditional criterion.
For Processing Types 'A' and 'U' (except for the above),specify the new Execution ID value for the selected networks
to be updated or added. When left blank, Execution ID is notchanged for Processing Type “U” or the value is taken from
Network Master for Processing Type “A”.
For a network with irregular Schedule Pattern, Execution ID is
specified as follows:①

For Processing Type (A2) “A”, Execution ID is
mandatory.

Specify a new Execution ID for the new

Network Schedule to be added for the “irregular”
Network.
②

For Processing Type (A2) “U”, specify a new Execution
ID only if you want to change it. Specify blank if there is
no change.

③
B7

Class

31

1

L&N

You can set it to 1 ~ 9, A ~ Z, or blank
This item is valid for Processing Type (A2) “A” or “U” only.
Specify the new Execution Class for the Network Schedule tobe added or updated. When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the Class
attribute of the Network defined in the Network Master.
For Processing Type (A2) “U”, it gets the value from the Class
attribute of the Network defined in one of the following
Masters and in this order; Daily Network Master and Network
Master.

5-20

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

1

You can specify” I” or “– “ or blank.

mn
B8

Input

32

Data Wait

Letter,Sign

Attribute

This item is valid for Processing Type (A2) “A” or “U” only.
Specify one of the following for the Network Schedule to be
added or updated.
I : Set Input Data Wait attribute (Not valid for Processing Type“A”)
- : Remove Input Data Wait attribute
When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the Input
Data Wait attribute of the Network defined in the Network
Master.
For Processing Type (A2) “U”, it gets the value from the Input
Data Wait attribute of the Network defined in one of thefollowing Masters and in this order; Daily Network Master andNetwork Master.
“I” can only be specified for a Network Schedule whose
Network Master is defined with Input Data Wait attribute.

B9

Hold
Code

33

1

L&N,

You can set it to 1 ~ 9, A ~ Z, -, or blank.

Sign

This item is valid for Processing Type (A2) “A” or “U” only.
Specify the new Hold Code for the Network Schedule to be
added or updated. Specify “-“ if Hold Code attribute is to be
removed. When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the Hold
Code attribute of the Network defined in the Network Master.
For Processing Type (A2) “U”, it gets the value from the Hold
Code attribute of the Network defined in one of the following
Masters and in this order; Daily Network Master and Network
Master.

5-21

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

1

P or - or blank can be specified.

mn
B10

Parallel

34

Run

Letter, SignAttribute

This item is valid for Processing Type (A2) “A” or “U” only.
Specify one of the following for the Network Schedule to be
added or updated.
P : Set Parallel Run attribute- : Remove Parallel Run attribute
When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from theParallel Run attribute of the Network defined in the Network
Master.
For Processing Type (A2) “U”, it gets the value from theParallel Run attribute of the Network defined in one of thefollowing Masters and in this order; Daily Network Master andNetwork Master.

B11

SystemQualifier

35

8

L&N,

You can set it to 1~9,A~Z,#,$,@,\,-.

Sign

This item is valid for Processing Type (A2) “A” or “U” only.
Specify the new System Qualifier for the Network Schedule tobe added or updated. When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the
System Qualifier attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from the
System Qualifier attribute of the Network defined in one of thefollowing Masters and in this order; Daily Network Master andNetwork Master.

5-22

5. Support Utilities

No.

Item

Colu

Size Type

Explanation2

You can set it to 01~15 or blank.

mn
B12

Priority

43

Numb
er

This item is valid for Processing Type (A2) “A” or “U” only.
Specify the new Priority for the Network Schedule to be added
or updated. When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from thePriority attribute of the Network defined in the Network Master.
For Processing Type (A2) “U”, it gets the value from thePriority attribute of the Network defined in one of the following
Masters and in this order; Daily Network Master and Network
Master.
B13

Start

45

4

Time

Numb

You can set it to 0001~4759 or 0000.

er

This item is valid for Processing Type (A2) “A” or “U” only.
Specify the new Start Time for the Network Schedule to be
added or updated in the format hhmm. Specify 0000 to
remove Start Time attribute. When left blank, the following
applies.
For Processing Type (A2) “A”, it gets the value from the Start
Time attribute of the Network defined in the Network Master.
For Processing Type (A2) “U”, it gets the value from the Start
Time attribute of the Network defined in one of the following
Masters and in this order; Daily Network Master and Network
Master.

B14

Unused49

1-This item will be ignored.

B15

Process

50

4

Numb

You can set it to 0000~9999.

erThis item is valid for Processing Type (A2) “A” or “U” only.

Time

Specify the new Processing Time for the Network Schedule tobe added or updated. When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from theProcessing Time attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from theProcessing Time attribute of the Network defined in one of thefollowing Masters and in this order; Daily Network Master andNetwork Master.

5-23

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

1

You can set it to Y or N or blank.

mn
B16

Monitor54

LetterOn

This item is valid for Processing Type (A2) “A” or “U” only.

Attribute

Specify one of the following for the Network Schedule to be
added or updated.
Y : Set Monitor On attribute (Input Data Wait attribute must be
defined)- : Remove Monitor On attribute
When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from theMonitor On attribute of the Network defined in the Network
Master.
For Processing Type (A2) “U”, it gets the value from theMonitor On attribute of the Network defined in one of thefollowing Masters and in this order; Daily Network Master andNetwork Master.

B17

Start
Delay

55

4

Numb

You can set it to 0001~4759 or 0000.

er

This item is valid for Processing Type (A2) “A” or “U” only.

Watch

Specify the new Start Delay Watch Time for the Network

Time

Schedule to be added or updated in the format hhmm. Specify
0000 to remove Start Delay Watch Time attribute. When left
blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the Start
Delay Watch Time attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from the Start
Delay Watch Time attribute of the Network defined in one of
the following Masters and in this order; Daily Network Masterand Network Master.
The value of Start Delay Watch Time must be smaller than
End Delay Watch Time (B18).

5-24

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

4

Numb

You can set it to 0001~4759 or 0000.

er

This item is valid for Processing Type (A2) “A” or “U” only.

mn
B18

End

59

Delay
Watch

Specify the new End Delay Watch Time for the Network

Time

Schedule to be added or updated in the format hhmm. Specify
0000 to remove End Delay Watch Time attribute. When left
blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the End
Delay Watch Time attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from the End
Delay Watch Time attribute of the Network defined in one of
the following Masters and in this order; Daily Network Masterand Network Master.
The value of End Delay Watch Time must be larger than Start
Delay Watch Time (B17).

B19

Time
Interval
End Time

63

4

Numb

You can set it to 0001~4759 or 0000.

er

This item is valid for Processing Type (A2) “A” or “U” only.
Specify the new Time Interval End Time for the Network
Schedule to be added or updated in the format hhmm. Specify
0000 to remove Time Interval End Time attribute. When left
blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the TimeInterval End Time attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from the TimeInterval End Time attribute of the Network defined in one of
the following Masters and in this order; Daily Network Masterand Network Master.
If a value is set for this item and Time Interval (B17) is set to0, it will cause a run-time error.

5-25

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

4

Numb

You can set it to 001~2879 minutes.

erThis item is valid for Processing Type (A2) “A” or “U” only.

mn
B20

Time

67

Interval

Specify the new Time Interval for the Network Schedule to be
added or updated in minutes. To remove Time Interval
function for the Network, specify 0000 in Time Interval End
Time item (B19). When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the TimeInterval attribute of the Network defined in the Network
Master.
For Processing Type (A2) “U”, it gets the value from the TimeInterval attribute of the Network defined in one of the following
Masters and in this order; Daily Network Master and Network
Master.
B21

Resource

71

1

L&N

You can specify” I” or “–“ or blank.

s UseThis item is valid for Processing Type (A2) “A” or “U” only.

Flag

Specify one of the following for the Network Schedule to be
added or updated.
I : Use Resource Management flag (Not valid for Processing
Type “A”.
- : Remove Resource Management flag
When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from theResource Management attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from theResource Management attribute of the Network defined in oneof the following Masters and in this order; Daily Network
Master and Network Master.
“I” can only be specified for a Network Schedule whose
Network Master is defined with Resource Management
attribute.

5-26

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

1

You can specify” I” or “–“ or blank.

mn
B22

Plug-in

72

Letter

BeforeThis item is valid for Processing Type (A2) “A” or “U” only.

Start flag

Specify one of the following for the Network Schedule to be
added or updated.
I : Use Plug-in Before Start flag (Not valid for Processing Type“A”.
- : Remove Plug-in Before Start flag
When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the
Plug-in Before Start attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from the
Plug-in Before Start attribute of the Network defined in one of
the following Masters and in this order; Daily Network Masterand Network Master.
“I” can only be specified for a Network Schedule whose
Network Master is defined with Plug-in Before Start attribute.

B23

Plug-in73

1

LetterYou can specify” I” or “–“ or blank.

AfterThis item is valid for Processing Type (A2) “A” or “U” only.

Start Flag

Specify one of the following for the Network Schedule to be
added or updated.
I : Use Plug-in After Start flag (Not valid for Processing Type“A”.
- : Remove Plug-in After Start flag
When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the
Plug-in After Start attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from the
Plug-in After Start attribute of the Network defined in one of
the following Masters and in this order; Daily Network Masterand Network Master.
“I” can only be specified for a Network Schedule whose
Network Master is defined with Plug-in After Start attribute.

5-27

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

4

Numb

You can set it to 0001~2880 or 0000 minutes.

erThis item is valid for Processing Type (A2) “A” or “U” only.

mn
B24

Max

74

ExecutingTime

Specify the new Maximum Executing Time for the Network
Schedule to be added or updated in minutes. Specify 0000 to
remove Maximum Executing Time attribute. When left blank,
the following applies.
For Processing Type (A2) “A”, it gets the value from the
Maximum Executing Time attribute of the Network defined in
the Network Master.
For Processing Type (A2) “U”, it gets the value from the
Maximum Executing Time attribute of the Network defined in
one of the following Masters and in this order; Daily Network
Master and Network Master.
If a value is set for this item, Response To Max Tme (B25)
must be set.

B25

Respons78

1

LetterYou can set it to ‘W’ or ‘C’.

e To Max

This item is valid for Processing Type (A2) “A” or “U” only.

Time

This item is not valid if Max Executing Time (B24) is set to
0000.
Specify one of the following for the Network Schedule to be
added or updated.
W : Output a warning message.
C : Output a warning message and Cancel Cold is issued tothe executing Network.
When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the
Response To Max Tme attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from the
Response To Max Tme attribute of the Network defined in oneof the following Masters and in this order; Daily Network
Master and Network Master.

5-28

5. Support Utilities

No.

Item

Colu

Size Type

Explanation

8

L&N,

You can set it to 1~9,A~Z,#,$,@.

Sign

This item is valid for Processing Type (A2) “A” or “U” only.

mn
B26

Job
ExecutingUser ID

79

Specify the new Job Executing User ID for the Network
Schedule to be added or updated. Specify “--------“ to remove
Job Executing User ID. When left blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the Job
Executing User ID attribute of the Network defined in the
Network Master.
For Processing Type (A2) “U”, it gets the value from the Job
Executing User ID attribute of the Network defined in one of
the following Masters and in this order; Daily Network Masterand Network Master.

5-29

5. Support Utilities

Card Type 1
Can be specified for Processing Type (A2) "A" or "U" only.
No.

Item

Colum

Size

Type

Explanation

-

-

-

Refer to common part6

1

NumberSpecify “1”.( Required)nCommonPart
C1

Card ID(Fixing)

C2

Network

7

12

L&N, Sign

User Field

A maximum of 12 alphanumeric characters can be
specified. Any characters exceeding 12 bytes aretruncated.
This item is valid for Processing Type (A2) “A” or “U”
only. Specify the new Network User Field for the
Network Schedule to be added or updated. When left
blank, the following applies.
For Processing Type (A2) “A”, it gets the value from the
Network User Field attribute of the Network defined in
the Network Master.
For Processing Type (A2) “U”, it gets the value from the
Network User Field attribute of the Network defined in
one of the following Masters and in this order; Daily
Network Master and Network Master.

Card Type 2
Can be specified for Processing Type (A2) "U" only.
No.

Item

Colu

Size

Type

Explanation

-

-

-

Refer to common part6

1

NumberSpecify “2”.( Required)mn
CommonPart
D1

Card ID(Fixing)

5-30

5. Support Utilities

No.

Item

Colu

Size

Type

1

LetterExplanationmn
D2

Precedenc

7

Specify one of the following Preceding Networke Network

Change Types to indicate how items (D3) and (D4) are

Changeto be applied. (Required)

Type

R:

Replace all the Preceding Network fields in theselected Network Schedules with the Preceding
Networks specified in item (D4).
D:Delete all Preceding Network fields in the selected

Network Schedules.
U:

Items (D3) and (D4) are ignored.

Update Preceding Networks according to thePreceding Network Change Sub-type item (D3).
D3

Precedenc

8e Network

19

Network Change Type (D2) is 'U'.

30

Each D3 item indicates the action to be taken for the

ChangeSub-type

1

LetterThis item can be specified only when the Precedingcorresponding Preceding Network item (D4).

41

A : Add the corresponding Preceding Network item (D4)
to the Preceding Network field in the selected Network
Schedules.
D : For the selected Network Schedules, delete thePreceding Network field that matches the Preceding
Network item (D4).
D4Preceding

9

Less

Network

20

than

L&N

The name of the preceding Network to change is
specified.

eight

31
42

*[L&N] means alphanumeric character.
(4) Execution result
Schedule Adjust Proof List
A-AUTO*** SCHEDULE ***DATE 2005/01/01 TIME

06:13:17

PROOF LIST OF MONTHLY SCHEDULE MAINTENANCE
(a)

(b)

----|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
FA0010TE

050417A|

FA0020TES

050417A|

FA0030TEST

050417A|(c)*** NO SYNTAX ERROR ***5-31

5. Support Utilities(a) The contents of the input card.
(b) When the specified card has an error. Syntax error code is displayed.
(c) When the specified card has an error. The details of a syntax error are displayed.

5-32

5. Support Utilities

Master Access Result List
A-AUTO*** SCHEDULE ***DATE 2005/01/01 TIME

06:13:17

PROOF LIST OF DNTWKLIB ACCESS INQUIRY
(a)

(b)

SCHEDULE(c)(d)

NETWORK(e)ACCESSRESULT

19990101

OLTM01ADD

OK(SCHEMSTR ONLY)

20000101

OLTM02ADDNG(SCHEMSTR ONLY)(a) Scheduled Date(b) Network Name(c) Processing Type(d) Access results(e) When only Schedule Master Type is changed, (SCHEMSTR ONLY) is displayed.

Sub-schedule Master Summary List
A-AUTO*** SCHEDULE ***DATE 2005/01/01 TIME

06:36:54

PROOF LIST OF MONTHLY SCHEDULE INQUIRY
(a)

(b)

SCHEDULE(c)
NETWORKMAXIMUM
DATE

(d)

(e)

(f)

NETWORK-EXPANDED

(g)

(h)
EX

(i)

ATTR

(j)

(k)

CLS

SYSTEMQUALIFIER

TIME

PRTY

START

EXECUTION
NAME

NAME

ID

USER ID(a) Schedule Date(b) Network Name(c) Network Expanded Name(d) Execution ID(e) Network Attribute(f) Class(g) System Qualifier(h) Priority(i) Start Time(j) Max Execution Time(k) Job Executing User ID
5-33

EXECUTION TIME

5. Support Utilities

Sub-schedule Master Detail List
A-AUTO*** SCHEDULE ***DATE 2005/01/01 TIME

06:36:54

PROOF LIST OF MONTHLY SCHEDULE INQUIRY(a)SCHEDULE DATE

(20050402)(b)NETWORK NAME

(OLTM04 )(c)NETWORK EXPANDED NAME((d)EXECUTION ID(A)(e)START TIME

(00:00)(f)NETWORK ATTRIBUTE)((g)CLASS(1)(h)PRIORITY(06)(i)NETWK USER FIELD)((j)INPUT DATA IDS

)

(

)(

(k)SYSTEM QUALIFIER

)(

)(

)(

)

(UNIX01 )(l)PRECEDING NETWORKS

1- 4(OLTM01 ) (

)(

)(

)

PRECEDING NETWORKS

5- 8

(

)(

)(

)(

)

PRECEDING NETWORKS

9-12

(

)(

)(

)(

)

PRECEDING NETWORKS 13-16

(

)(

)(

)(

)

(m)START TIME LIMIT(n)END TIME LIMIT

(

:

(

:

(o)TIME INTERVAL END TIME(p)INTERVAL (MIN)

)
)

(

:

(

)

(q)RESOURCE FLAG()(r)PLUG-IN BEFORE START()(s)PLUG-IN AFTER END((t)MAXIMUM EXECUTION TIME)((u)RESPONSE TO MAXIMUM TIME(v)EXECUTION USER ID

)

)
()

(

)

(a) Scheduled Date(b) Network Name(c) Network Expanded Name(d) Execution ID(e) Start Time(f) Network Attribute(g) Class

5-34

5. Support Utilities(h) Priority(i) Network User Field(j) Input Data Wait ID(k) System Qualifier(l) Precedence Network ID(m) Start Delay Watch Time(n) End Delay Watch Time(o) Time Interval End Time(p) Time Interval(q) Resource Management Flag(r) Plug-in flag Before Start(s) Plug-in flag After End(t) Max Execution Time(u) Response to Max Time(v) Job Executing User ID(5) Other

All the card files are checked for correct syntax first before the Master file is updated. As long as one set ofcards has SYNTAX error, update of the Master file will not be executed.

When a new line is coded in the middle of a card, all subsequent columns of the line are as assumed to beblanks.

5-35

5. Support Utilities■ chkd utility
Delete Network Data ,Free-On, Free-Off(1) Function
chkd utility performs the following processing for a specified network or Network Group in the Network Check file.
For a Network Group, the processing is applied to all Networks in the group.
 Delete the data information of the specified Network or Network Group from the Network Check file
 Free-On the specified Network or Network Group in the Network Check file
 Free-Off the specified Network or Network Group in the Network Check fileNote
Do not execute chkd utility when mcp is running.
When the chkd utility was performed and a track record is created, For queuing network already , please rerun the search queue XQ command.

(2) Command Input
chkd ∆ -m Mode [∆{-n Network | -gNetwork Group} ] ∆ -d Date
<1>
<2>
<2>
<1>

<2>

Mode:

<4>

Select one of the following processing to be performed.
Delete,del,

DELETE,

freeon,on.

FREEON, ON……..Free-On

freeoff,

off,

FREEOFF, OFF…..Free-Off

Network:

DEL……Delete

Specify the name of the Network to be processed. Name must be between 2 and 8

characters.
(For Delete mode, prefix can be specified)
If this parameter is not specified, an error message (CHKD001E) is displayed andprocessing is terminated. To specify network prefix for Delete mode, append an “*” to theend of the partial Network name and enclosed this in quotation marks (e.g. 'ANET*').
<3>

Network Group:

Specify the group name of the Network Group to be processed. Group name must

be between 2 and 8 characters.
If this parameter is not specified, an error message is displayed and processing isterminated.
<4>

Date:

Specified a Schedule Date in the format of yymmdd.
This parameter is not valid for Delete mode.

Except for the date specification for Delete mode, all of these parameters are mandatory.

5-36

5. Support Utilities■ chkl utility
Network End Status List Output(1) Function
chkl utility output a list showing the termination information of Networks.

(2) Command Input
chkl [∆{-n Network|-g Network Group}] [∆ -s Sort conditions][ ∆-Output Detail]
<1>
<2>
<3>
<4>
[∆ -p The number of form feed lines](5)<1> Network:

Specify the name of the Network to be listed. Name must be between 2 and 8 characters.

(Default is all Networks are listed.)

If the detailed output of <4> is selected, it will list detailed

information from Network Queue File, Network Tom File, and Checkpoint File.
<2> Network Group:

Specify the group name of the Network Group to be listed. Group name must be

between 2 and 8 characters.

If the detailed output of <4> is selected, it will list detailed informationfrom Network Queue File, Network Tom File, and Checkpoint File.
<3> Sort conditions:<4> Output Detail:Select one of the following.
Net:

The output will be in ascending order by network name. (Default)

Date:

The output will be in ascending order by Queuing Schedule Date.

Select one of the following.
O:

Output detailed information.

None:

Detailed information is not output. (Default)<5> The number of form feed lines: Specify the number of lines per page.(Maximum 999)
(Default: 56 Line)If <1> and <2> are not specified, all Networks in Network Check file are listed.

5-37

5. Support Utilities

e.g.5-5chkl utility% chkl
A-AUTO

V7.2.2.00
PAGE 1
DATE:2011/11/30 TIME:13:19:39(C)Copyright BSP INC. 1994******* NETWORK CHECK LIST ******OPERATION DATE : 11/11/29
NETWORK Q-SDATE ENDDATE STARTEND
ATTR RC STATUS
AFDL01 111129 111128 000000/000000 000000/000000
00 NORMAL
AFDN01 111129 111128 000000/000000 000000/000000
00 NORMAL
AFKH01 111129 111128 000000/000000 000000/000000
00 NORMAL
AFKL01 111129 111128 000000/000000 000000/000000
00 NORMAL
AFTD01 111129 111128 000000/000000 000000/000000
00 NORMAL****** END OF PRINT *****% chkl -o
A-AUTO

V7.2.2.00
PAGE 1
DATE:2011/11/30 TIME:13:53:13(C)Copyright BSP INC. 1994******* NETWORK CHECK LIST ******OPERATION DATE : 11/11/30
NETWORK Q-SDATE ENDDATE STARTEND
ATTR RC STATUS
AFDL01 111130 111129 000000/000000 000000/000000
00 NORMAL<<< QUEUING DATA -- NETWORK QUEUE FILE >>>SDATE CLASS PRTY STATUS Q-TYPE ATTR SYSQQTIME LID
111130 A
600
N0000 0
BSPEND 111130 111129 000000/000000 000000/000000
00 NORMAL<<< QUEUING DATA -- NETWORK QUEUE FILE >>>SDATE CLASS PRTY STATUS Q-TYPE ATTR SYSQQTIME LID
111130 A
600
N0000 0
BSPSTA
111130 111130 111130/135105 111130/135115
00 NORMAL
OLTM01 111130 111130 111130/135123 111130/135134
00 NORMAL
OLTM02 111130 111130 111130/135134 000000/000000
20 ACTIVE<<< ACTIVE DATA -- NCBPREFIX >>>SDATE STARTENDSTATUS1 ATTR STATUS2 RC ACT-CNT LID
111130 111130/135134 000000/000000 00
80
00 1
0
OLTM03 111130 111130 111130/135134 111130/135144
00 NORMAL
OLTM04 111130 111130 111130/135134 111130/135135
12 ABEND<<< ABNORMAL DATA -- NETWORK TOM FILE >>>SDATE STARTENDSTATUS1 ATTR STATUS2 RC ACT-CNT LID
111130 111130/135134 111130/135135 00
80
12 0
0
OLTM05 111130 111130 000000/000000 000000/000000
04 CANCEL****** END OF PRINT *****

5-38

5. Support Utilities

Descriptions of items
If AUTO_LOGTIMEON is set to “1” in the Windows version, note that additional information (about 26 columns) will beappended to the left of each message displayed.
◆ –o option is not specified
Item

Position

Size

Explanation

NETWORK1

8

Network Name

Q-SDATE

10

6

The operation date of A-AUTO when this network was last queued.

ENDDATE

18

6

The operation date of A-AUTOwhen this network was last ended.

START

26

13

CPU start time when this network was completed.
YYMMDD/hhmmss

END

40

13

CPU end time when this network was completed.
YYMMDD/hhmmss

ATTR

55

1

Monitoring On Attribute

RC

60

2

The return code when the Network ended.

STATUS

64

12

Termination Status when the Network ended
NORMAL/CANCEL/SCRIPT ERROR/ABEND/ACTIVE◆ -o Option is specified<<<QUEUING DATA -- NETWORK QUEUE FILE>>>
Item

Position

Size

Explanation

SDATE

10

6

Schedule Date

CLASS

19

1

Class

PRTY

24

2

Priority

STATUS

30

2Status

Q-TYPE

37

1

Rerun Type, Normal Type

ATTR

43

1

Monitoring On Attribute

SYSQ

47

8

System Qualifier name

QTIME

56

4

Network Start Time

LID

63

1

Job Library ID<<<ACTIVE DATA – NCBPREFIX>>>
Item

Position

Size

Explanation

SDATE

10

6

Schedule Date

START

17

13

YYMMDD/hhmmss

END

31

13

YYMMDD/hhmmss

STATUS1

47

2

Processing status at the time when the network ends.

ATTR

54

1

2:

The cancellation free-on command was issued.

4:

The network was started by job specification.

8:Free-onInvalid5-39

5. Support Utilities

Item

Position

Size

Explanation

STATUS2

60

2

Network processing status.
It is a combination of the following flags.
0x08: Release
0x40: Cancel
0x20: WARM Cancel
0x08: Stop
0x04: FORCE Cancel
0x02: COLD Cancel

RC

66

2

Network End Status

ACT-CNT

71

2

The number of executing jobs.

LID

78

1

Job Library ID<<< ABNORMAL DATA -- NETWORK TOM FILE >>>Item

Position

Size

Explanation

SDATE

10

6

Schedule Date

START

17

13

YYMMDD/hhmmss

END

31

13

YYMMDD/hhmmss

STATUS1

47

2

Processing status at the time when the network ends.
2:

The cancellation free-on command was issued.

4:

The network was started by job specification.

8:Free-on

ATTR

54

1

Invalid

STATUS2

60

2

Network processing status.
It is a combination of the following flags.
0x08: Release
0x40: Cancel
0x20: WARM Cancel
0x08: Stop
0x04: FORCE Cancel
0x02: COLD Cancel

RC

66

2

Network End Status

ACT-CNT

71

2

Invalid

LID

78

1

Job Library ID

5-40

5. Support Utilities■ dsfi utility
Reset Information of Data Arrival(1) Function
dsfi utility is used to cancel all the data arrival of the Data Wait Flags i.e. reset all Data Wait Flags to off.
(2) Command Input
dsfi
e.g.5-6

dsfi utility% dsfl -n
A-AUTO/UNIX(WindowsNT)

VERSION 3.0.0
PAGE 1
DATE:2003/07/25 TIME:21:06:43(C)Copyright BSP INC. 1996******* DATASET FLAG STATUS LIST ******OPERATION DATE:03/07/07
SEQ
NETWORKN-STT
DSFLAGF-STT
ON-DATE
ON-TIME
001 BSPEND
1
DATA6
1
03/07/25 22:15
002 BSPSTA
0
DATA1
0
******** *****
DATA2
1
03/07/25 21:06****** END OF PRINT ******

If dsfi is performed in the above-mentioned data arrival situation, all the Data Wait flags will be reset as follows.
% dsfi% dsfl -n
A-AUTO/UNIX(WindowsNT)

VERSION 3.0.0
PAGE 1
DATE:2003/07/25 TIME:21:10:28(C)Copyright BSP INC. 1996******* DATASET FLAG STATUS LIST ******OPERATION DATE:03/07/07
SEQ
NETWORKN-STT
DSFLAGF-STT
ON-DATE
ON-TIME
001 BSPEND
0
DATA6
0
******** *****
002 BSPSTA
0
DATA1
0
******** *****
DATA20******** *********** END OF PRINT ******

Note


Note that Data Wait flags once reset by execution of the dsfi utility cannot be reverted.

5-42

5. Support Utilities■ dsfl utility
List Input Data Wait Master Information(1) Function
dsfl utility is used to list the following information about Data Wait IDs and the networks which are registered into
Input Data Wait Master.
 Relation between Networks and Data Wait IDs
 The current status of the Data Wait ID i.e. on or off
 The date and time when the Data Wait ID flag was set to ON
dsfl utility may list the above information in either the ascending order of the network name or the ascending orderof Data wait ID.
(2) Command Input
Dsfl ( [∆-nNetwork] ) ( [∆-iData] )<1><2>
To list in ascending order of Network name<1>

Specify the name of the Network to be listed. Name must be between 2 and 8 characters.
Prefix can be specified.
To specify network prefix, append an “*” to the end of the partial Network name and enclosed this inquotation marks (e.g. 'ABCD*').
When ALL or * or blank is specified, the information about all the Data Wait IDs defined in the
Input Data Wait Master will be listed in order of Network name.
To list in an ascending order of Data Wait ID<2>

Specify the Data Wait ID to be listed. Data Wait ID must be between 1 and 8 characters.
Prefix can be specified.
To specify Data Wait ID prefix, append an “*” to the end of the partial Data Wait ID and enclosed thisin quotation marks (e.g. 'ABCD*').
When ALL or * or blank is specified, the information about all the Data Wait IDs defined in the
Input Data Wait Master will be listed in order of Data Wait ID* Only one option parameter, <1> or <2>, can be specified.
(3) Command Input
dsfl

5-43

5. Support Utilities

e.g.5-7

dsfl utility% dsfl
A-AUTO

V7.2.2.00
PAGE 1
DATE:2011/11/30 TIME:14:03:57(C)Copyright BSP INC. 1996******* DATASET FLAG STATUS LIST ******OPERATION DATE:11/11/30
SEQ
NETWORKN-STT
DSFLAGF-STT
ON-DATE
ON-TIME
001 BSPSTA0
D0******** *****
DS1
11/11/30 13:57
DSI0******** *********** END OF PRINT ******

A-AUTO******* DATASET FLAG STATUS LIST ******SEQ
DSFLAGNETWORK NAME
001 D
BSPSTA002 DS
BSPSTA003 DSI
BSPSTA****** END OF PRINT ******

V7.2.2.00
PAGE 2
DATE:2011/11/30 TIME:14:03:57(C)Copyright BSP INC. 1996
OPERATION DATE:11/11/30
COMMENT

Descriptions of the items
If it is set to "1" AUTO_LOGTIMEON In the Windows version, Please note the gap 26 column.
Item

Position

Size

Explanation

SEQ

2

3

Sequence Number

NETWORK8

8

Network Name

N-STT

21

1

Data Wait flag for each network. 1: All Data Wait flags for the Network
have arrived

DSFLAG

27

8

Data Wait ID

F-STT

40

1

Data Wait flag for each Data Wait ID.

1: Data Wait flag for that Data

Wait ID has arrived
ON-DATE

46

8

Data Wait Flag arrival CPU date.

YY/MM/DD

ON-TIME

57

5

Data Wait Flag arrival CPU time.

hh:mm

Item

Position

Size

Explanation

SEQ

2

3

Sequence Number

DSFLAG

8

8

Data Wait ID

NETWORK

19

8

Network Name

36

44

Comment Information

NAME
COMMENT

5-44

5. Support Utilities■ dsfo utility
Set Data Wait Flag to ON or OFF(1) Function
dsfo utility is used to set the Data Wait flag of a specific Data Wait ID in Input Data Wait Master to ON or OFF. ON
means that the data, usually external to A-AUTO MONITOR, has arrived while OFF means that the data has not
arrived.
(2) Command Input
dsfo [∆-Type] ∆Data
(1)
(1)

Type:

Indicates ON or OFF setting of a Data Wait flag of a Data Wait ID.
n:
f:

(2)

Data:

(2)

Set Data Wait flag to ON i.e. arrived.
Set Data Wait flag to OFF i.e. has not arrived.

Specify the Data Wait ID whose Data Wait flag is to be set. Up to 8 Data Wait IDs can beset, each to be separated from the other with a space. Each Data Wait ID must be 8 or less characters.

e.g.5-8

dsfo utility

Data Wait IDs of ds01 and ds02 are set to indicate data have arrived.
dsfo -n ds01 ds02
Data Wait IDs of ds03 and ds04 are set to indicate data have not arrived.
dsfo -f ds03 ds04

5-45

5. Support Utilities■ esvcrt utility
Network Monitor Information Re-create(1) Function
esvcrt utility re-creates the network and job information into the Network Information File and the Job Information Filethat have been initialized.
(2) Command Input
esvcrte.g.5-9esvcrt utility% esvcrt
ECU003I ESVCRT UTILITY
SUCCESS( 51 )NG( 0 )IS

TERMINATED

ESVN

SUCCESS(

29

)NG(

0

)

ESVJ

Please follow the following procedures to execute this utility.
①

Hold the Network Queue so that ready to execute Networks may not be started. [cip hq]②

Issue da command to check that no Network is executing. If there is, wait for all executing Networks toend. [cip da]③

Stop the Application Monitoring from A-AUTO/Web Client. Then initialize the Job Information File andNetwork Information File and execute this utility using the sample script file/Batch file below.

A-AUTO for UNIX
rm $AUTODIR/files/aux_esvnfile_i
rm $AUTODIR/files/aux_esvnfile_d
rm $AUTODIR/files/aux_esvjfile_i
rm $AUTODIR/files/aux_esvjfile_d
rm $AUTODIR/files/asv_fesvnst
rm $AUTODIR/files/asv_fesvned
rm $AUTODIR/files/asv_fesvndl
form -l -tesvnfile
form -l –tesvjfile
asvform -tfesvnst
asvform -tfesvned
asvform -tfesvndl
esvcrt5-46

5. Support Utilities

A-AUTO for Windows
set autofile=\bsp\auw\files →Please according to the environment have been introduced
del %autodir%\auw_esvnfile_i
del %autodir%\auw_esvnfile_ddel %autodir%\auw_esvjfile_i
del %autodir%\auw_esvjfile_ddel %autodir%\asv_fesvnst
del %autodir%\asv_fesvned
del %autodir%\asv_fesvndl
form -l -tesvnfile
form -l -tesvjfile
asvform -tfesvnst
asvform -tfesvned
asvform -tfesvndl
esvcrt④

The utility uses the information in the Network Queue to recreate information into Network Information
File and the Job Information File.

⑤

Please perform [Delete Record] from Application Monitoring screen of A-AUTO/Web Client.

⑥

Release queue to continue A-AUTO operations.

5-47[cip aq]

5. Support Utilities■ esvdel utility
Network Monitor Information Maintenance and Re-organization(1) Function
An esvdel utility is used to delete old and unused records in Network Information File (refer to as ESVN) and Job
Information File (refer to as ESVJ) and then re-organize these files. Records in ESVN and ESVJ files are createdand updated by A-AUTO Monitor. Input date parameter for the utility determines the records for deletion.
When esvdel utility is executed, back up files are created in the same directory as ESVN and ESVJ files. If theutility abnormally ends, you can restore ESVN and ESVJ files by renaming those back up files to their original
names.
Note that, if this utility is executed consecutively more than once, the contents of the backup files cannot be
assured.
* esvdel utility creates intermediate files during the execution.
* Please refer to “2.4 Estimating System Data File Size” in System Administrator’s Guide for the details on filesize.
Before Execution

After Execution (Backup File)aux_esvjfile_d

aux_esvjfileback_d

aux_esvjfile_i

aux_esvjfileback_i

aux_esvnfile_d

aux_esvnfileback_d

aux_esvnfile_i

aux_esvnfileback_i

By incorporating this utility into the asvsfin utility, ESVN and ESVJ files will be reorganized whenever the asvsfin is
executed. This makes periodic maintenance of ESVN and ESVJ files unnecessary.

(2) Sample asvsfin shell script (UNIX) / Batch file (Windows)
A-AUTO for UNIX#!/bin/csh
source $AUTODIR/autoenv.csh
form -l -tnetwkstk
rm$AUTODIR/files/fin_temp
rm$AUTODIR/files/fin_temp2
schexrt -mf -ffin_def -wfin_temp -dautodate
auxninf -mf -wfin_temp -rfin_temp2
auxfin -mr -rfin_temp2
esvdel -k 2
crtaja -rfin_temp2
exit 0

← Add

5-48

5. Support Utilities

A-AUTO for Windows@echo off
set autofile=\bsp\auw\files
rem ----- Delete Temporary file ----form -l -tnetwkstk
del %autofile%\fin_temp
del %autofile%\fin_temp2:schexrt
schexrt -mf -ffin_def -wfin_temp -dautodate
rem It is an error display if an error level is 1 more
if errorlevel 1 goto schexrt99:auwninf
auwninf -mf -wfin_temp -rfin_temp2
IF errorlevel 1 goto auwninf99:auwnfin
AUWFIN -mr -rfin_temp2
IF errorlevel 1 goto auwnfin99
esvdel -k 2

← Add

:crtaja
crtaja -rfin_temp2
IF errorlevel 1 goto crtaja99:nomalend
goto exit99
rem ----- Error Message Display ----:schexrt99
echo ##### schexrt abnomal end ######
goto exit99:auwninf99
echo ##### auwninf abnomal end ######
goto exit99:auwnfin99
echo ##### auwnfin abnomal end ######
goto exit99:crtaja99
echo ##### crtaja abnomal end ######
goto exit99:exit99
pause

5-49

5. Support Utilities(3) Command Input
The parameter that can be specified in esvdel utility is described to (1) ~ (2).
If you did not specify any parameter, an error will occur.
①

Specific Dateesvdel ∆-d∆YYYYMMDD

The data from the specified date to the current date is extracted into new ESVN and ESVJ files.
(Data of the specified date will be included)
e.g.5-10 esvdel utility (Specific Date)esvdel -d

20010203

The data from February 3, 2001 to the present is extracted into new ESVN and ESVJ files.
Note

When a future date is specified, empty ESVN and ESVJ files are created.

This specification cannot be used with -k (Retention days specification) or -f (Deletion Date range
specification).

②

Retention days specification
esvdel ∆-k∆ Retention days

The data for retention days is extracted into new ESVN and ESVJ files.

Retention days refer to the number of days ofdata since current CPU date to be kept in the ESVN and ESVJ files.
Retention days of "0~365" can be specified.
Retention day of "1" is means only the data for "today", "2" means data for "today and yesterday." and "3" means datafor "today, yesterday, and the day before yesterday".
e.g.5-11 esvdel utility (Retention days)
esvdel -k

7

The data from six days before to today is extracted into ESVN and ESVJ files.

Note

If specify “0” for Retention day , empty ESVN and ESVJ files are created.

Retention day must be a numeric value.

This specification cannot be used with -d (Specific Date specification) or -f (Deletion Date range
specification).

5-50

5. Support Utilities③

Deletion Date Range specification
esvdel ∆-f∆ Deletion Date Range[∆-n Deletion Object Network Name]

The data of the specified date range is deleted and the other remaining data is extracted into new ESVN and ESVJ files.
Deletion Date Range can be specified in the format of YYYYMMDDYYYYMMDD.

By specifying a network name using -n, only the data of the specified network name for the specified date range isdeleted.

e.g.5-12 esvdel utility (Deletion Object period specification)
esvdel -f

2011080120110830-n oltm01

The data of OLTM01 for the period from August 1, 2011 to August 30, 2011 is deleted. The remaining data is
extracted into new ESVN and ESNJ files.

NoteThis specification cannot be used with -d (Specific Date specification) or -k (Retention Days
specification).

-n (network name specified) can be specified only when -f (Deletion Date Range) is specified.

5-51

5. Support Utilities■ fdump utility
Output Hexadecimal Dump of a SEQ File
(1) Function
fdump utility is a batch utility to output hexadecimal dump of a SEQ file.
(2) Command Input
fdump [∆-Type] [∆-|Record size] ∆ Input and output file
<1>
<2>
<3>
<1> Type:

Specify the output code. If not specified, it outputs in an ASCII code.
Specify e for EBCDIC Code.

<2> Record size: Specify the length of one record to be output. If not specified, the length of one record willbe 256 bytes.
<3> Input and output file:e.g.5-14

Input and output file name is specified.

fdump utility
Network master (ISAM file) is output in100 bytes per record in EBCDIC code.
fdump -e -l100 netwklib
Data Wait master (ISAM file) is output in 94 bytes per record in ASCII code.
fdump -l94 dsflagtb
Sample output of a sequential file of a Network Master in 800 bytes per record in an ASCII code. The
sequential file name is aux_netwkseq.

% fdump -l800 aux_netwkseq
DATA DUMP Block 0(The size of record: 800)00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0123456789ABCDEF
000000 41 46 44 4C 30 31 20 20 20 20 00 01 00 00 41 46 AFDL01....AF
000010 44 4C 30 31 20 20 20 20 00 00 00 00 00 20 41 55 DL01..... AU
000020 4E 49 58 30 31 20 20 00 00 00 03 30 36 30 30 30 NIX01 ....06000
000030 30 8C DA 8B 71 C3 DE B0 C0 DB B0 C4 DE 8F 88 97 0...q...........
000040 9D 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
000050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20000060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20000070 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20000080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
・
・

5-53

5. Support Utilities

Record length for file
The record length for main files to be dumped are shown below..
File Name
Network master

File Type (*)

Size

netwklib

800

Input data wait management master dsflagtb

192

Holiday master

hldymstr

640

Schedule masterschemstr

540

Daily Network masterdntwklib

400

Cross-Master Network masterpntwklib

48

Monitor File(Network information)

esvnfile

768

Monitor File(Job information)

esvjfile

768(*) About File Type
This "file type" is a name to be specified as the argument for form utility or asvform utility.
Actual file names for sequential files have ’auw_’ or ’asv_’ prefix. Actual file names for ISAM files
have ’auw_’ prefix and ’_i ‘(index) or ’_d’(data) suffix.

5-54

5. Support Utilities■ form utility
Loading / Unloading / Format of A-AUTO Monitor's Master files(1) Function
form utility is used to format a Master file, load a sequential file containing Master data into a Master file andunload a Master file to a sequential file.

SEQ File

Unloadform

Select Master
Load

Schedule Master

Network Master

Input Data Wait
MasterHoliday Master

The notes at the time of form utility use
Since the mismatching of a master file may occur if this utility is performed during queuing execution, please
do not perform simultaneously.

5-55

5. Support Utilities(2) Command Input
form ∆-Type ∆-t Select Master
<1>
<1>

Type:
|:

[∆ Input and Output File]

<2>

<3>

[∆ -b]<4>

Select Load or Unload.
File initialization and loading are performed.
The processing performed differs depending on the file type of the file selected in item <2>.
Processing if file selected is an ISAM fileAn index file and a data file are created and initialized, andthe key definition is

performed.
If item <3> is specified, the data of the sequential file is loaded into the Master file.
Processing if file selected is a SEQ file
A sequential file is created and initialized.

U:

File unload is performed.
It is effective only when an ISAM file is specified in item <2> [Select Master].

<2>

The master file to be created and initialized. (Required)
The following are the ISAM files that A-AUTO monitor uses and their respective file types.
 netwklib
Network Master dsflagtb

Input Data Wait Master netwkchk

Network Check File netwktom

Abnormal End Network File schemstr

Schedule Master hldymstr

Holiday Master dntwklib

Daily Network Master pntwklib

Cross-Master Preceding Network Master groupdef

Network Group Master jobdef

Job Define Master netwkjob

Job Information Master plugindef

Plug-in Master netjpara

Network Parameter Master jobdefr3

R3 Job Define Master jobdefr3step

R3 Job Step Master resdef

Resource Management Master

5-56

5. Support Utilities<3> Input and Output File:

For “I” specified in item <1> (loading), specify the name of the sequential file that

contains the data to be loaded into the Master file. For “U” specified in item <1> (unloading), specify thename of the sequential file to be created when the Master file is unloaded.

<4> Endian conversion option:
Specify whether to perform endian conversion when performing unload.
This option is effective only when unloading one of the following Master files; Network
Master/Input Data Wait
Master/Schedule Master/Holiday Master/Daily Network Master/Network Group
Master/R3 Job Define Master/R3 Job Step Master/Parameter Master/Plug-in
Master/Resource Management Master/Job Information Master/Job Define Master. The
endian conversion is only for integer data of Master file.
Note

SEQ files used by the A-AUTO monitor are as follows:
It is possible to also load and unload the following SEQ files in a form utility.
(You may back up using the copy command of OS.)
netwklgx
Network LogX
netwklgy
Network LogY
netwkque
Network Queue
netwkstk
Network Stockevmtckpt
Environment Check Point File

The following files cannot be loaded and unloaded using the form utility.
(It can carry out by the copy command of OS.)

afileverFile Version

filachis

Data update file

When an ISAM file already exists, initialization of the ISAM file is not performed.
(To perform initialization of an ISAM file, it is necessary to delete the ISAM file first before executing theform utility.)Initialization of a SEQ file is always performed whether the SEQ file exists / does not exists.

When data is loaded to an ISAM file and the ISAM file contains a record with the same key as the dataof a SEQ file to be loaded, the record is replaced by the data of the SEQ file.



Item <3> [Input and Output File] parameter must be specified when unloading data from an ISAM file.



By a client, during master edit, please specify (4) [Endian conversion option] and do not unload it.
When the master after conversion is used, there is a case where it becomes impossible to edit with thestatus "Editing"5-57

5. Support Utilities

e.g.5-15

form utility
Initialize the network master (ISAM file).
form - l -tnetwklib
Initialize the network stock (SEQ file).
form - l -tnetwkstk
data1 is an input file whose data is to be loaded to Input Data Wait Master(ISAM file).
form - l -tdsflagtb $AUTODIR/files/data1(c:\BSP\AUW\FILES\data1)
data1 is an input file whose data is to be loaded to Network Queue File(SEQ file).
form - l -tnetwkque $AUTODIR/files/data1(c:\BSP\AUW\FILES\data1)
data1 is an input file whose data is to be loaded to Network Check File(ISAM file).
form - u -tnetwkchk$AUTODIR/files/data1(c:\BSP\AUW\FILES\data1)

data1 is an input file whose data is to be loaded to Network Stock File(SEQ file).
form - u -tnetwkstk$AUTODIR/files/data1(c:\BSP\AUW\FILES\data1)

5-58

5. Support Utilities(3) Reorganization on ISAM File
An ISAM file can be reorganized by using a form utility.
After an ISAM file is used in operations for a while, through adding or deleting records, the file size will
increase even if the number of records does not increase. This is due to the characteristics of an ISAM file.
To avoid this, ISAM reorganization must be performed periodically by using the following procedures.
①

ISAM file is unloaded to a SEQ file.

②

ISAM file is to be saved.

③

The ISAM file is created, initialized and loaded with data from the SEQ file using the form utility.

Note
Reorganization should be done while the Network Queue is held or while A-AUTO MONITOR is not active.
e.g.5-16

Reorganization of Daily Network Mater
Please be sure to take a backup before reorganizing.

A-AUTO for UNIX
Sample shell (csh)* It is a prerequisite that a backup directory exists.

#!/bin/csh
source $AUTODIR/autoenv.csh
mv $AUTODIR/files/aux_netwkseq $AUTODIR/install/backup
form -u -tnetwklib $AUTODIR/files/aux_netwkseq
mv $AUTODIR/files/aux_netwklib_i $AUTODIR/install/backup
mv $AUTODIR/files/aux_netwklib_d $AUTODIR/install/backup
form -l -tnetwklib $AUTODIR/files/aux_netwkseq
exit 0A-AUTO for Windows
Sample batch* It is a prerequisite that a backup directory exists.

@echo off
set autofile=\bsp\auw\files
set backup=\bsp\auw\backup
move %autofile%\auw_netwkseq %backup%
form -u -tnetwklib %autofile%\auw_netwkseq
move %autofile%\auw_netwklib_i %backup%
move %autofile%\auw_netwklib_d %backup%
form -l -tnetwklib %autofile%\auw_netwkseq
pause

5-59

5. Support Utilities■ log0 utility
Log File Output List
(1) Function
log0 utility is a batch utility to list the contents of A-AUTO Monitor's log file.
Input to this utlity can be from one of the following files.

Network LogX(netwklgx)
Network LogY(netwklgy)
Backup File(YYYYMMDDhhmmss)* A backup file refers to a file that is created whenever the number of Network Log records exceeds apredefined system parameter value.
A backup file is stored in directory “backup_netwklg” under the FILES directory.
The predefined system parameter is MCP_MAXNWKLOG of auto_sysconf.
(2) Command Input
log0 [∆ -d Operation date range] [∆-f File Name] [∆-all] [∆-j Job Name] [∆-n Network
<1>
<2>
<3>
<4>
<5>
Name] [∆-g Network Group Name] [∆-u Job Executing User ID]
<6>
<7>
<1>

Operation date range:

Specify a range of Operation Dates for which Networks executed under these
Operation Dates are to be listed. If not specified, current A-AUTO Monitor'sOperation Date is used.
Only the date which carried out yyyymmdd or yymmdd specification is
outputted.
Output the yyyymmdd~yyyymmdd or yymmdd~yymmdd Specified period list
The list from the date to the present which carried out yyyymmdd or yymmdd
specification is outputted.
The list to the date which carried out yyyymmdd or yymmdd specification is
outputted.

<2>File Name:

<3>

all:

<4>

Job Name:

Specify the file name of a backup file that is to be used as input file.
This is specified if both Network Log and a backup file are to be used as input.
Specify Job name if only specific job is to be listed. Prefix Job name can be specified

by appending ‘*‘ to the end of the partial Job name.
.
<5>

Network Name: Specify Network name if only specific Network name is to be listed. Prefix Network

name can be specified by appending ‘*‘ to the end of the partial Network name.

5-60

5. Support Utilities<6> Network Group Name:

Specify Network Group name if only Networks belonging to the group are to be listed..

<7> Job Executing User ID:

Specify Job Executing User ID if only Networks that executed under the specified Job

Executing User ID are to be listed..

5-61

5. Support Utilities

e.g.5-17log0 utility

List only Networks belonging to network group name GRP01 that have been executed.
log0 -gGRP01
A-AUTO Monitor's current Network Log is used as input.
A-AUTO******* NETWORK LOG LIST ******NETWORKGROUPID JOBNAME
RSYSQ
USER-ID
BSPSTAGRP01
BSPSTA01 00
AUTOUSR
BSPSTAGRP01
BSPSTA02 00
AUTOUSR
OLTM01
GRP01
OLTM0101 00****** END OF PRINT ******

V7.2.2.00
PAGE 1
DATE:2011/11/30 TIME:16:04:59(C)Copyright BSP INC. 1994
OPERATION DATE:11/11/30
RC CODE C T ST-DATE START END
ELAPSE CPU
A N 11/11/30 160320 160330

0.10

0.000 11/11/30 0

A N 11/11/30 160330 160330

0.00

0.000 11/11/30 0

A N 11/11/30 160341 160351

0.10

0.030 11/11/30 0

5-62

SDATE

LID

5. Support Utilities

Column and item description
If AUTO_LOGTIMEON is set to “1” In the Windows version, note that additional information (26 columns) will beappended to the left of each message displayed.
Also, in the case of the Windows version, the column position of CPU is listed at column 74.
Item

Position

Size

Explanation

NETWORK1

8

Network NameGROUPID

11

8

Network Group NameJOBNAME

20

8

Job Name

RC

29

2

Network End Status

CODE

32

4

Job End Code

C

37

1

OS Execution Class (Unused)

T

39

1

Execution Type N: Normal Type

ST-DATE

41

8

Start Date. YY/MM/DD

START

50

6

Start Time

END

57

6

End Time

ELAPSE

67

4

Job Execution Elapse Time. Unit (min. sec).

CPU

75(74)

4

Time when CPU resources were assigned to job processing.

R: Rerun TypeCPU time (sec)
SDATE

80

8

Schedule Date. YY/MM/DD

LID

90

1

Job Library ID

RSYSQ

94

8

System Qualifier Name

USER-ID

103

8

Job Executing User ID

CODE Explanation
CODE displayed in the list comes from either one of the two sources. The first source is the exit code thatthe job (application, a batch, shell) returned at the end of its execution. The second source is a code that
A-AUTO returned when a communication fault occurred between A-AUTO Monitor and A-Remote during
job activation or execution of a job.
CODE returned by A-AUTO is summarized in the table given below.
(Note that the meanings of CODEs are different for different versions of A-Remote. Check the version of
A-Remote used in your site before checking the meanings of the CODEs. )CODEs

for different versions*1

A-AUTO for Windows
A-AUTO for UNIX

*2

*3

―

―

―

―

v4.0.0Lv14 or later

Up to v4.0.0Lv13

v5007a or later

Up to v5006a

V722Lv00 or later
A-REMOTE for Windows
A-REMOTE for UNIX

5-63

5. Support Utilities★:*Only 1
CODE

Problem generating

*2

0001

Error in socket generation of TCP/IP communication.
0001 0001 Please check SYSQCONF file to ensure that host name is defined correctly.

0002

0002

0003

0003

0004

0004

0005

0005

0006

0006

0007

0007

0008

0008

0009

0009

0010

0010

0011

Non

0020

0020

0021

0021

0022

Non

0030

0030

0031

0031

0032

0032

*3

Meaning

A-REMOTE for
System i
A-REMOTE for
Windows
A-REMOTE for
UNIX
A-AUTO
Monitor*1

Error in connection with the remote point.
0002 armtux/armtnt has been started , please check that it is the communication stateis able to communicate.
Error in transmission of the job activation demand at the remote point.
0003 Please check that it is in the state where communication can have a goodunderstanding.
Error in reception processing of the notification of job end from the remote side.
[KeepAlive Function] is not used.
0003 Please check that it is in the state where communication can have a goodunderstanding.
The TCP/IP session was lost during reception processing of the notification of job
end from the remote side. [KeepAlive Function ] is not used.Please check a0003 communicative state. Moreover, please check whether armtux/armtnt iscompleted or not.
[KeepAlive Function] is used. Error in check processing on whether received
data had arrived. Please check that it is in the state where communication can
0003 have a goodunderstanding.
[KeepAlive Function] is used. Since there was no transmission from the remoteside after a specified time of KEEPALIVE use, it treats it as a loss in
0007 communication and carries out abnormal end treatment for the job. Please checkthat it is in the state where communication can have a goodunderstanding.
[KeepAlive Function] is used. Error in reception processing of the notification of
Job end.
0003 Please check that it is in the state where communication can have a goodunderstanding.
KeepAlive Function] is used. The TCP/IP session was lost during reception
0003 processing of the notification of Job end. Please check a communicative state.
Moreover, please check whether armtux/armtnt is completed or not.
Failed to set the process of waiting when an error occurs.
0004 Note error message and contact our support team.
Since the information on the remote job for recovery does not exist in a job
Non execution status file, abnormal end treatment of the job is carried out. Pleasecheck whether A-REMOTE is already restarted.
execscr failed in the generation of the job process.
Non Please check that the job file and the shell script have “execute” authority.
●
Error in execution of the job.
0100 There is a possibility that there was insufficient memory or the maximum number ●of the processes specified by the user is reached.
There was error in the logon using the specified Job Executing User ID. Please
Non check whether user ID and password are correctly defined in the User ★
Information Definition file (userdef).
Error in generation of the rmtscr process by armtux.
There is a possibility that there was no “execute” authority in rmtscr, there was0004 insufficient memory, or the maximum number of the processes specified by theuser is reached.
At the remote point, rmtscr failed in generation of the job execution process.
There is a possibility that there was insufficient memory or the maximumNonnumber of the processes specified by the user is reached.
The job could not be executed at the remote point.
0100 Please check that the shell script has “execute” authority.

5-64

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

●

★

●

★

●

★

5. Support Utilities

CODE
*2

0033

0033

0034

Non

Non

0040

Non

0041

Non

0042

0050

0050

*3

Meaning

In the remote point, a job is already performing in the same JP partition. Make
sure there is no problem if a job is running at a remote destination , even if you
exit the job , please be terminated by the kill command. By the case where theNon job is not performed, when this message was displayed, A-REMOTE for UNIXmight not be completed normally last time, but the shared memory may haveremained. Please reboot armtux.
Error in starting Job at the remote point.
Non The information on JP division or the job information on relevance might havebeen unable to acquire at the remote point.
Error in generation of the thread for registration of a cancellation command.
Non Note error message and contact our support team.
Error in generation of the job execution process at the remote point. Please
Non check that the job file has “execute” authority.
The job execution thread for cancellation was not found.
Non There is a possibility that the job has already completed at the remote side.
Error in transmission of the job activation demand to jslinkrj from an execscr
0001 process. Please check that AP-LINK of A-AUTO Monitor side is started, andjslinkrj has started normally.

A-REMOTE for
System i
A-REMOTE for
Windows
A-REMOTE for
UNIX
A-AUTO
Monitor*1

Problem generating

●

★

●

●
●
●
●
●

Although transmission of the message was tried to the Remote Job Start
Function
0051

0051 0002(System i), It was not able to transmit after trying the maximum number of times●

to retry specified in

0052

environment variable RJ_MAX_CONN_REQ.
Please check that the remote job start function (System i) has started.
Error in transmitting processing of the job activation demand from jslinkrj at the
remote point.
0052 0003 Please check that the SYSQCONF file and the communication environment
setup of AP-LINK of A-AUTO monitor side are correct.

●

In addition, when a communication fault occurs during a starting error or job activation of a job, RC (return code) which
A-AUTO sets up and returns is 8.

5-65

5. Support Utilities■ logcheck utility
Log keyword CheckThis function is valid only for Windows version.

(1) Function

logcheck utility is used to process a file and search for specific character string in the file. It is especially
useful for an application job that displays successful or not successful message to the output log but does
not return a return code.

A value can be set when the search for the string is found.

In order to use this utility, an application job needs to re-direct its output messages to a log file.

(2) Command Input
logcheck∆ Log File Name ∆ Search String ∆ Return value of search success
<1>
<2>
<3>

<1>

Log File Name:

The full path of the log file name which application creates.

<2>

Search String:

The character string to search for in the log file (Please put on the Position whichcanbe referred to.)<3>

Return value of search success:A value to return when search finds the specified character string in

the log
file (0~253)
254 is returned when the specified character string is not found.
255 is returned when there is error in the execution of the utility itself, such as a parameter error.

e.g.5-18

logcheck utility
bspapp.exe is the application which outputs a log to "c:\bsp\log\bspapp.log."
0 is returned when the character "SUCCESSFUL" is output by the application.
@echo off
Bspapp.exe > c:\bsp\log\bspapp.log
logcheck c:\bsp\log\bspapp.log SUCCESSFUL 0
aexit %ERRORLEVEL%
exit

5-66

5. Support Utilities■ mdump utility
Hex dump output of (shared memory) control block(1) Function
mdump utility is a batch utility which output Hexadecimal dump of control block (Shared memory) of A-AUTO
Monitor.
The mdump utility is only valid when A-AUTO Monitor is active.
If the utility is executed while A-AUTO Monitor is not active, low value data is displayed.

(2) Command Input
mdump
e.g. 5-2

mdump utility
Output Hexadecimal dump of control block (Shared memory) of A-AUTO Monitor.
mdump
If sysid is specified as a parameter, version level of the A-AUTO Monitor is displayed.

A-AUTO for UNIX example
This means it is Ver7 level 00.
% mdump sysid
DATE: 2008/08/22 TIME: 21: 18: 04
SYSID
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0123456789ABCDEF
000000 00 00 00 00 41 55 54 4F 30 31 00 00 00 00 00 00 ....AUTO01......
000010 00 00 00 00 00 00 00 00 00 00 00 00 56 37 31 30 ............V710
000020 30 30 00 00 00 00 00 00 00 00 00 00
00..........

5-92

5. Support Utilities

A-AUTO for Windows example
This means it is Ver7 level 00. (If 0 is set in AUTO_LOGTIMEON)
C: \>mdump sysid
DATE: 2008/08/22 TIME: 21: 18: 04
SYSID
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0123456789ABCDEF
000000 00 00 00 00 41 55 54 4F 30 31 00 00 00 00 00 00 ....AUTO01......
000010 00 00 00 00 00 00 00 00 00 00 00 00 56 37 31 30 ............V710
000020 4C 30 30 00 00 00 00 00 00 00 00 00
L00.........

5-93

5. Support Utilities■ mkusrdef utility
User Information Encryption utility* This utility is available in the version of A-AUTO for UNIX/Windows V7.2.2 and later(1) Function
mkusrdef utility is used in conjunction with Switch Job Execution User ID Function. It encodes the User
Password part of Job Executing User ID’s account information and then output an encoded User Information
Definition File (userdef) to the directory that is defined in system parameters FILES_PATH. This encoded filecontains user account information that is used by A-AUTO Monitor.
The Input File (CSV file that contains Job Executing User ID’s account information) must be createdprior

to executing this utility.

(2) Command Input
mkusrdef ∆-iInput File Name [∆-u]<1><1> Input File Name<2>
Set the name of the input CSV file. (Required).
If full path of Input File is not specified, it gets the file from current directory.

<2> Output Mode

Set the output method of User Information Definition File.
Omitted: Create a new User Information Definition File.
-u is Set: Add User Information to existing User Information Definition File.
If the same Job Executing User ID exists in User Information Definition File,the utility will update it.

5-96

5. Support Utilities(3) Input File Format
Input File Format as the following.

#

Item Name

Need

Size

1

Job Executing User ID○

1~8

Explanation
Alphanumeric, @#$Please make sure that there is no duplicate
Job Executing User ID i.e. Job Executing
User ID must be unique.

2

Domain of user

3

User ID

4

User Password○

32

Specify domain of the user.

1~20

Specify actual User ID to execute Job.

20

Specify password of the user (Will be
Encrypted by the utility).

5

Comment

144

Specify comment for the user。

e.g. 5-4 Input File Example

USER01,SRV001,usr01,pass01, 1st Division operationT
USER02,SRV001,usr02,pass02
USER03,,usr03(4) mkusrdef utility Execution
Run mkusrdef as follows.
(The utlity uses an input file input.csv that is saved in current directory.)mkusrdef -iinput.csv

The execution result of the utility is output to the console as follows.
2010/12/07 20: 00: 30 MKUSRDEF MKU001I MKUSRDEF START
2010/12/07 20: 20: 30 MKUSRDEF MKU002I RESULT: TOTAL (3) OK (3) NG (0)2010/12/07 20: 23: 53 MKUSRDEF MKU003I MKUSRDEF END RC = 0.

The following content will be output to an encoded file, User Information Definition File (userdef)
USER01,SRV001,usr01,4EE5C669D0427845A928BFD1C343804DAD58D314,1st
Division operationT
USER02,SRV001,usr02,4EE5C669D04143281B6D80016934E2146C9CC7A5,
USER03,,usr03,3E4AC2E13A9D083C8F1FA6372B8B6AEBF6B43FAC,

Note<1> Please backup the User Information Definition File before you run this utility.
<2> The maximum number of User Information that can be added in User Information Definition File is
9999.

5-97

5. Support Utilities■ netlist utility
Network Information List Output(1) Function
Use netlist utility to output the information of all the registered Networks and Jobs in Network Master.
(2) Command Input
netlist[∆-dDate][∆-gNetwork Group][∆-plines per Page]
<1>
<2>
<3>
<1>Date: yyyymmdd or yymmdd
Set Valid Date.
If it is set, output the Network and Job information of Networks whose Valid Date matches
the specified date.
If it is not set, output all the information.

<2>Network Group: 2~8 alphanumeric characters

Set Network Group ID.
If it is set, output the Network and Job information of Networks that belong to that Group..
<3>Lines per Page

: ××× (Max 999)

Specify the number of lines to be listed on 1 page before a page break.
If it is not set, there will be no page break. And if you do not want to display the title oneach page break, set -pi.

5-98

5. Support Utilities

e.g 5-5

netlist utility
When you input netlist command, the Network Master information is listed as follows.
% netlist********************************************************************************NETLIST**
A-AUTO for WindowsNT
PAGE 1 **========================================================================= <C>=**NETWORK EFFECTDATE (MAX6)**------------------------------------------------------------------------- <N>-**NETWORK NETWORK_SHORT_NAME PRTY STIME ATTR INFO_USER SYSQ C RTIME **PREVIOUS NETWORKS (MAX16)**EXEC-TIME USER-ID SDELAY EDELAY INTVAL END-TIME RESOURCE PLG (B) PLG (A) **------------------------------------------------------------------------- <J>-**JNO JOBNAME PREVIOUS JOBS ( MAX6 JOBS ) MXRC D INFO-USER USER-ID ********************************************************************************===========================================================================<C>=
ANET01 E2011/11/30--------------------------------------------------------------------------- <N>E2011/11/30
ANET0106 ---CONN2 A 5m
AUTOUSR 0000 0000 0000 0000 OFF OFF OFF--------------------------------------------------------------------------- <J>010 ANET01 000 000 000 000 000 000 1
020 ANET02 010 000 000 000 000 000 1===========================================================================<C>=
BNET01 E2011/11/30--------------------------------------------------------------------------- <N>E2011/11/30
BNET0106 ---CONN1 A 3m
ANET01
10 W
0900 1500 0000 0000 OFF OFF OFF--------------------------------------------------------------------------- <J>010 BNET01 000 000 000 000 000 000 1
020 BNET02 010 000 000 000 000 000 1
ADMIN===============================================================================TOTAL NETWORK RECORDS => ( 0002 )TOTAL NETWORKS => ( 0002 )5-99

5. Support Utilities

Explanation of Items
If AUTO_LOGTIMEON is set as 1 in Windows version, note that additional information (29 columns) will be appended to
the left of each message displayed.
Also, the column position is different in the case of Windows version.

===========================================================================<C>=
Valid Date/Expiry Date Information (1~5 item)
Valid Date/Expiry Date Information (6 item)--------------------------------------------------------------------------- <N>Network Valid Date
Network Information
Preceding Network Information (1~8 item)
Preceding Network Information (9~16 item)
Network Information 2--------------------------------------------------------------------------- <J>Job Information■ Valid Date/Expiry Date Information * Up to 2 lines of Valid Date / Expiry Date Information may be displayed depending on
number of Valid Date / Expiry Date values (maximum 6).
Position Length Explanation
1

8

Network Name

11

11

Valid Date or Expiry Date (Valid Date: Eyyyy/mm/dd, Expiry Date: Xyyyy/mm/dd)

23

11

Valid Date or Expiry Date (Valid Date: Eyyyy/mm/dd, Expiry Date: Xyyyy/mm/dd)

25

11

Valid Date or Expiry Date (Valid Date: Eyyyy/mm/dd, Expiry Date: Xyyyy/mm/dd)

47

11

Valid Date or Expiry Date (Valid Date: Eyyyy/mm/dd, Expiry Date: Xyyyy/mm/dd)

59

11

Valid Date or Expiry Date (Valid Date: Eyyyy/mm/dd, Expiry Date: Xyyyy/mm/dd)■ Network’s Valid Date
Position Length Explanation
1

11

Valid Date (Eyyyy/mm/dd) of Network■ Network Information
Position Length Explanation
1

8

Network Name

11

20

Network Comment

32

2

Priority

36

5

Start Time

42

1

Hold Code43

1

Input Data Wait Attribute44

1

Job Parallel Run

5-100

5. Support Utilities

45

1

Monitor On Attribute

48

12

User Information

62

8

System Qualifier

71

1

Network ■Class73 (75) 5

Execution Time (m)■ Preceding Network Information *Up to 2 lines of Preceding Networks may be displayed depending on number ofpreceding Networks (maximum 16).
Position Length Explanation
1

8

Preceding Network Name

11 (10) 8

Preceding Network Name

21 (19) 8

Preceding Network Name

31 (28) 8

Preceding Network Name

41 (37) 8

Preceding Network Name

51 (46) 8

Preceding Network Name

61 (55) 8

Preceding Network Name

71 (64) 8

Preceding Network Name

■ Network Information 2
Position Length Explanation
1

4

Max Executing Time

61

Response To Max Time11

8

Job Executing User ID

21

4Start Delay Watch Time28

4

End Delay Watch Time

35

4Interval

42

4Time Interval End Time

51

3

Resource Flag

60

3

Plug-in Before Start Flag

67

3

Plug-in After Start

Flag■ Job Information
Position Length Explanation
1

3

Job Number

6

8

Job Name

16

3

Preceding Job Number

21

3

Preceding Job Number

26

3

Preceding Job Number

31

3

Preceding Job Number

5-101

5. Support Utilities

36

3

Preceding Job Number

41

3

Preceding Job Number

46

3

MAX-RC (0~127)51

1

Dummy Network <D>

54

12

Job User Field

67

8

Job Executing User ID

Explanation of Network Number
netlist utility also displays the following information at the end of Network Master list.


TOTAL NETWORK RECORDS
This shows the total number of the Networks that is registered with the Network Master including Networks
with same Network ID but different Valid Date or Expiry Date.

TOTAL NETWORKS
This shows the total number of the Networks that is registered with the Network Master.

5-102

5. Support Utilities■ resm utility
Resource Management Function(1) Function
resm utility is used to perform the Resource Management Function. The utility provides the following facilities
for Resource Management; Resource Manual Release, Resource Forced Release, Cancel Resource Wait,
and Usage Status of Resource.
For more details of Resource Management Function, please refer to “8.3 Resource Management” of User's
Guide.

(2) Command Input
resm [[∆-rResource ID]∆-nNetwork Name[∆-jJob Number]][∆{-v|-a|-af|-c}]
<1>
<2>
<3>
<4>
[∆sdate=Schedule Date]<5><1> Resource ID :Set target Resource ID.

<2> Network Name:

Set target Network Name

<3> Job Number

if the target is a Job in the Network,:

Set the Job Number of the Job in the Network specified in <2><4> Type:

Select Command Type from one of the following. (Required)■-v : Display the Usage Status of Resource.
■-a : Manually Release the specified Resource which is in Wait status.
■-af : Forced Release the specified Resource.
■-c : Perform the Cancel Resource Wait.

<5> Schedule Date

: Set the Schedule Date of the Network in the format yymmdd or yyyymmdd.
Default is Operation Date.

(3) Parameter of each Command TypeThe description of the necessary parameters for performing each Command Type.
 -v (Display the Usage Status of Resource) If you do not set all other parameters (resm -v)
Display all the Resources being used.
Please refer to e.g. 5-28
 If you set a Network (resm -nNetwork -v)
It displays the Usage Status of all the Resources which is related with specified Network only.
You may limit the Resource to be displayed by setting Resource ID.
(resm -rResource ID -nNetwork -v)

5-115

5. Support Utilities
 If you set Job Number of Network (resm -nNetwork -jJob Number -v)
It displays the Usage Status of all the Resources which is related with specified Job of
Network only.
You may limit the Resource to be displayed by setting Resource ID.
(resm -rResource ID -nNetwork -jJob Number -v)
 -a (Resource Manual Release), -af (Resource Forced Release), -c (Cancel Resource Wait.) If you set Network (resm -nNetwork {-a | -af | -c})
Perform the appropriate operation specified in Command Type to the Resources relatedwith specified Network.
You may limit the Resource to be operated on by setting Resource ID.
(resm -rResource ID -nNetwork {-a | -af | -c})
 If you set Job Number of Network(resm -nNetwork -jJob Number {-a | -af | -c})
Perform the appropriate operation specified in Command Type to the Resources relatedwith specified Job of Network.
You may limit the Resource to be operated on by setting Resource ID.
(resm -rResource ID -nNetwork -jJob Number {-a | -af | -c})e.g. 5-10 resm utility (Display the Usage Status of all Resources)
resm -v
A-AUTO

V7.2.2.00
DATE: 2011/11/30 TIME: 15: 14: 50(C) Copyright BSP INC. 1994************ RESOURCE VIEW LIST ************ OPERATION DATE : 11/11/30
RESID RESNAME MAX-P REMAIN TYPE NETWORK JOBNUM JOB USE-P RELEASE STATUS DATE
RES0001 session 60 0 N OLTM02
60 AUTO ACTIVE 20111130 15: 14: 27
N OLTM03
30 AUTO WAIT
RES0002 thread1 60 0 N OLTM02
60 AUTO ACTIVE 20111130 15: 14: 27
RES0003 thread2 20 20 N OLTM03
10 AUTO WAIT
RES0016 thread15 10 0 N OLTM04
10 MANUAL RELEASEON 20111130 15: 14: 30
RES0017 thread16 10 0 N OLTM04
10 MANUAL RELEASEON 20111130 15: 14: 30
RES0018 thread17 10 0 J OLTM04 010 OLTM0401 10 MANUAL RELEASEON 20111130 15: 14: 30*************** END OF PRINT ***************
RSM007I TERMINATE WITH DUE TO 0

5-116

5. Support Utilities

e.g. 5-11 resm utility (Manual Release a specific Resource of a specified Network)
resm -rres0016 -noltm04 -a sdate=20111130
RSM005I RESOURCE RELEASE OK, NETWORK=OLTM04
RSM007I TERMINATE WITH DUE TO 0

e.g. 5-12 resm utility (Cancel Resource Wait of a Resource for a specified Job of a Network)
resm -rres0008 -noltm03 -j010 -c sdate=20111130
RSM006I RESOURCE WAIT CANCEL OK, NETWORK=OLTM03, JOB=010
RSM007I TERMINATE WITH DUE TO 0

5-117

5. Support Utilities

Explanation of Items
If AUTO_LOGTIMEON is set to 1 in Windows version, note that additional information (about 26 columns) will beappended to the left of each message displayed.
Item

Position

Length Explanation

RESID

1

8

Resource ID

RESNAME

10

20

Resource Name

MAX-P

31

5

Resource Max UsageREMAIN

37

5

Number of Resources Remaining

TYPE

44

1

Resource Type (Resource target)
N: Network
J: JobNETWORK49

8

Network ID

JOBNUM

58

3

Job Number

JOB

65

8

Job Name

USE-P

74

5

Resource Usage

RELEASE80

6Resource Release TypeMANUAL: Manual Release
AUTO: Auto Release

STATUS

88

9

Resource Use Status
ACTIVE: Resource obtained Successfully
WAIT: Waiting for Resource
RELEASEON: Manual Release Wait

DATE

98

17

Resource Acquisition Date

5-118

5. Support Utilities■ rmakdnwk utility
Reorganization of Daily Network Master(1) Function
rmakdnwk utility is used to reorganize Daily Network Master.
Perform it regularly to prevent that the size of Daily Network Master file from becoming too big.

When the rmakdnwk utility is executed, backup files are created. If the rmakdnwk utility ends abnormally, you
can restore the Daily Network Master by renaming these backup files to their original names. Names of
backup files are ‘aux_dntback_i’ and ‘aux_dntback_d’.

(2) Command Input
rmakdnwk[∆-f ]-f

If this parameter is specified, the utility wil be forced to reorganize the Daily Network
Master without exclusive control of this Master.
If this parameter is omitted, the Daily Network Master is reorganized with exclusive
control.

Note
Note when executing rmakdnwk with exclusive control (without –f)

As rmakdnwk utility requires exclusive control of Daily Network Master, the utility may wait continuously until
the file is closed if it is being used by other process. Therefore, execute this utility while all A-AUTO/Web
Clients have logged out.

Note when executing rmakdnwk with -f set
If –f is specified, rmakdnwk utility reorganizes the file without exclusive control. Therefore, do not execute thefollowing while rmakdnwk utility is being executed.
■A-AUTO/Web Client Log-in■Execution of the following utilities
autosche utility
remakesche utility
sfin utility■Enter the Monitor Commands
Queuing Command
Start Command
Display Command

5-122

5. Support Utilities

e.g. 5-16 rmakdnwk utility
1.

Ensure all A-AUTO/Web Clients have logged out.

2.

Perform rmakdnwk utility#!/bin/csh
source $AUTODIR/autoenv.csh
echo ">>Start rmakdnwk"
rmakdnwk
set STATUS = $status
switch ( $STATUS )case 0:echo ">>dntwklib Remake COMPLETED ($STATUS) "exit 0breaksw
default:echo ">> dntwklib Remake FAILED ($STATUS) "exit 1endsw

e.g. 5-17 rmakdnwk utility Output Result
RDN001I RMAKDNWK STARTS
RDN002I RMAKDNWK NOMAL END

5-123

5. Support Utilities■ schelist utility
List Schedule Information■ This utility is available only in Stand-alone Mode version(1) Function
schelist utility is used to output the Network Schedule information of Networks registered in Schedule Masterand in ascending order of Network name. The output lists one month of Network Schedules of the Networks.
Note
The output content is the same as [Network Schedule List] of Schedule Master maintenance, schelist utility
only can display the Schedule information since CPU Date.

(2) Command Input
schelist ∆-dDate [∆-e ]<1><2><1> Date:

Specify the Date to be displayed in the format of yymm or yyyymm.

<2> Expiry Date Option: You can display a simulated Schedules based on a specified Expiry Date. This isuseful to confirm the effect of a Expiry Date on Network Schedules before executing
remakesche utility.
* If a new Expiry Date for a Network is registered into Network Master after Network Schedule for thisNetwork has been created, the Network Schedule is not automatically updated toreflect the changes as a result of the new Expiry Date.

remakesche utility must be

executed to update Network Schedule. By specifying Expiry Date Option for this utility,
the utility will list the Network Schedules based on the simulated changes using theExpiry Date. You may then confirm whether the changes to Network Schedules arecorrect before proceeding to execute remakesche utility, which will update the Network
Schedules pemanently.
e.g. 5-18 schelist utility
List one-month of Network Schedules

starting from January 2004.

% schelist -d0401
NETWORK 200401 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 …
Customer processes Data Load
AFDL01 * * * * * * * * * * * * * * * * * * * * * …
Customer processes DB update
AFDN01 * * * * * *** **…
Transfer 1 to Osaka
AFKH01 * * * * * * * * * * * * * * * * * …
Customer processes DB delete
AFDX01* …
Note that even if that month does not have 31 days, the header will still display 31 days.

5-127

5. Support Utilities

Explanation Items
For this utility, even if AUTO_LOGTIMEON in Windows is set to 1, there is no additional information appended.
Position Length Explanation
1

8

Network

18

1

The 1st of specified month by parameter.

21

1

The 2nd of specified month by parameter.

24

1

The 3rd of specified month by parameter.

27

1

The 4th of specified month by parameter.

30

1

The 5th of specified month by parameter.

33

1

The 6th of specified month by parameter.

36

1

The 7th of specified month by parameter.

39

1

The 8th of specified month by parameter.

421

The 9th of specified month by parameter.

45

1

The 10th of specified month by parameter.

48

1

The 11st of specified month by parameter.

51

1

The 12th of specified month by parameter.

54

1

The 13th of specified month by parameter.

57

1

The 14th of specified month by parameter.

60

1

The 15th of specified month by parameter.

63

1

The 16th of specified month by parameter.

66

1

The 17th of specified month by parameter.

69

1

The 18th of specified month by parameter.

72

1

The 19th of specified month by parameter.

75

1

The 20th of specified month by parameter.

78

1

The 21st of specified month by parameter.

81

1

The 22nd of specified month by parameter.

84

1

The 23rd of specified month by parameter.

871

The 24th of specified month by parameter.

90

1

The 25th of specified month by parameter.

931

The 26th of specified month by parameter.

96

1

The 27th of specified month by parameter.

99

1

The 28th of specified month by parameter.

102

1

The 29th of specified month by parameter.

105

1

The 30th of specified month by parameter.

108

1

The 31st of specified month by parameter.

* If the month does not have 29th, 30th and 31st, also display the header in 31 days.

5-128

5. Support Utilities■ toml utility
Display Termination Information of ABEND Network(1) Function
toml utility is used to display the termination information of Abend (Abnormally Ended) Network.

(2) Command Input
toml[∆-n Network][∆-Date][∆-pNumber of row to be displayed in one page]
<1>
<2>
<3>
<1> Network:

Specify a Network ID consisting of between 2 and 8 alphanumeric characters. If
the Network ID is the only parameter to be specified, all data regarding thespecified Network ID is displayed. If the Schedule Date is the only parameter to be
specified, all data associated with the specified Schedule Date is displayed. Ifneither the Network ID nor the Schedule Date is specified, all data in the
Abnormally terminated Network file is listed.

<2> Date:

Specify Schedule Date in the format of yymmdd or yyyymmdd.

<3> Number of row to be displayed in one page: Specify the number of lines per page before a page break.
(0~999)Specify 0 if no page break is required. (Default: 56 lines)

e.g. 5-19 toml utility% toml
A-AUTO

V7.2.2.00 PAGE 1
DATE: 2011/11/30 TIME: 16: 15: 44(C) Copyright BSP INC. 1994******* NETWORK TOM LIST ******OPERATION DATE : 11/11/30
SDATE NETWORK GROUPID JOBNAME JB# T ST RC STARTEND-T REASON
USER-ID
111130 BSPSTA GRP01 BSPSTA01 010 N 80 12 111130/161506 161516 JOB ABENDED
AUTOUSR
BSPSTA02 020 N 01 00 000000/000000 000000 PREVIOUS JOB ABENDED AUTOUSR****** END OF PRINT *****

5-129

5. Support Utilities

Explanation of Items
AUTO_LOGTIMEON is set to 1 in Windows, note that additional information (about 26 columns) will be appended to theleft of each message displayed.
Item

Position

LengthExplanation

SDATE

1

6

Schedule Date of Abend Network

NETWORK88Abend Network NameGROUPID

17

8

Network Group Name of Abend Network

JOBNAME

26

8

Job Name of the Job in the Network

JB#

35

3

Job Number

T

39

1

Start Type of Network
N: Normal Type

ST

41

2

R: Rerun TypeEnd status of Job
80: Job has Ended (Normal End / Abnormal End)
84: Job is cancelled

RC

44

2

Job Return Code

START

47

13

Job Start CPU Date and time.

END-T

61

6

CPU Time when Job End. hhmmdd

REASON68

26

Job Status

YYMMDD/hhmmdd

JOB ABENDED: Abnormally EndedSCRIPT ERROR: Script Error
JOB CANCELED: Cancelled
JOB CANCELED DUE TO M-TIME: JOB CANCELED DUE Max
Executing Time exceeded
JOB TERMINATED: Normal End
PREVIOUS JOB ABENDED: Preceding Job, Abnormally Ended
FAILED TO LOGON: Failed to Log on by the specified Job Executing
User IDJOB RECOVERY FAILED: Failed to Recover.
USER-ID

95

8

Job Executing User ID

5-130

７. Remote Job Execute Function Utility

7 Remote Job Execute Function Utility■ aexit utility
・This is an utility for A-Remote for Windows.
(1) Function
aexit utility is used to set Return Code of a batch Job. In a Job (batch file), use this utility to set Return
Code just before exiting the batch Job using ‘exit’ command (MS-DOS command). If an invalid value or avalue not in the range from 0 to 255 is specified, it is recognized as Abnormal End and 255 is returned.
In WindowsNT Jobs, Return Code cannot be determined unless this utility is used.
In Windows2000 or later version, Return Code is set by ’exit’ command. It is unnecessary to use aexit.
Note:
A-AUTO for Windows accepts Return Code in the range from 0 to 255. If ’exit’ command sets a value outof the range, A-AUTO for Windows cannot recognize the Return Code correctly. To prevent this problem, it
is recommended to use aexit utility even for Windows 2000 or later. This is because aexit utility will reset
the return code value to 255 if the value specified is outside the range..
* The maximum value of Max Return Code is 127.

(2) Command Input
aexit

Return code①

① Return Code: Specify a value in the range of 0 to 255.

Example@echo off
if exist .\test.dat goto: OK
goto: NG: OK
echo OK
aexit 0exit
: NG
echo NGaexit 10exit

7-1

７. Remote Job Execute Function Utility■ armtntje utility
・This is an utility for A-Remote for Windows.
(1) Function
When A-Remote cancels the execution of a Job, armtntje utility is used to cancel the child process, which
may have been initiated or activated by the actual Job.

armtntje utility must be used if a Job to be

executed under A-Remote for Windows will initiate or execute another Job or process. Specify armtntje
with the program to be initiated as the first argument followed by the actual arguments of program to be
initiated. Return Code of armtntje will be the Return Code of initiating program.

(2) Usual case

A-REMOTE for Windows

JOB001.batecho ### START JOB ###Initiateremjobloop never stop !!!

JOB001
jobloop.bat
JOBLOOP

When A-Remote cancels
JOBLOOP is not canceled.

･･･

JOB001,(3) With armtntje

A-REMOTE for Windows

JOB002.batecho ### START JOB ###Initiaterem

JOB002

jobloop never stop !!!

armtntje jobloop.bat
armtntje
JOBLOOP
When A-Remote cancels JOB002, JOBLOOP isalso canceled.

7-2･･･