A-AUTO for UNIX/Windows V7 オペレーションガイド 50 for Windows_… · Explanation of messages output by A-AUTO for UNIX/Windows and is provided in html format. [Target audience:

A-AUTO

A-AUTO for UNIX

A-AUTO for Linux

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

http://www.apache.org/�

About this Manual

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

■Marks

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

yyyy, yy 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 date

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

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

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

Describes the functions of A-AUTO for UNIX/Windows system.

[Target audience: System Administrator / Operation Manager / Operator]

A-AUTO for UNIX/Windows User’s Guide

Describes the system parameters and environment variables settings, and system

maintenance, resources required to run the system, limitations of the system.


A-AUTO for UNIX/Windows System Administrator’s

Describes the operating procedures such as commands of the system, and the utilities of

A-AUTO for UNIX/Windows.


A-AUTO for UNIX/Windows Operations Guide

◆This document

Describes the procedures to install and setup the A-AUTO for UNIX/Windows System.


A-AUTO for UNIX/Windows Setup Guide

Explanation of messages output by A-AUTO for UNIX/Windows and is provided in

html format.


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.

A-AUTO for UNIX/Windows Messages & Codes

1. Monitor Commands

1-1

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 in

interactive 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∆aq

In the case of Interactive method

aq

This 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. Monitor Commands

1-2

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 result

of executing Ctrl+C.

1. Monitor Commands

1-3

1.1 Command Log of A-AUTO for Windows

In A-AUTO for Windows, when system parameter AUTO_LOGTIMEON is set to 1, additional information

such as the name of the command/utility, and the date and time of command/utility will be appended to the

display.

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

1-5

1.3 Detailed Descriptions of Monitor Commands

1.3.1 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. Monitor Commands

1-6

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

released, 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, then

NP 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. Monitor Commands

1-7

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

released, 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, then

JP 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. Monitor Commands

1-8

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

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

released. If system parameter “NCP_USE_OLDESTDATE” is set to 0, which is the default value,

Operation Date will be applied.

1. Monitor Commands

1-9

■ 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. Monitor Commands

1-10

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 and

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

command.). 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 other

systems. If COLD Cancel command is issued and the executing Job could not be terminated, it is

necessary to check the execution status of the Job. It may be necessary to use FORCE Cancel to

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

a 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. Monitor Commands

1-11

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

*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. Monitor Commands

1-12

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


<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


canet0001,w



AUX001I COMMAND VALID AUX409I NETWORK ANET0001 REQUESTED TO BE CANCELED AT NJP

1. Monitor Commands

1-13

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


<2>Date : Specify Schedule Date of the Network to be canceled in the format of


<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


canet0001,f,sdate=040520



(3) Limitation of FORCE Cancel

FORCE Cancel should be used only when COLD/WARM Cancel is ineffective and the Network cannot be

terminated.

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 the

system)

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 to

be terminated before a FORCE Cancel command by following the procedures listed below.

1. Monitor Commands

1-14

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

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

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

process ID by using ”ps –ef | grep execscr”. Then, force execscr process to terminate by using kill

command 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. Monitor Commands

1-15

<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 COLD CANCEL 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 BSPSTA SDATE=2007/03/20 AT NP 001 HAS BEEN CLEARED BY FORCE CANCEL $ log0 2004/05/24 18:59:23 log0: AUX008I NETWORK LOG FILE EMPTY $ toml 2004/05/24 18:59:24 toml: AUX008I NETWORK TOM IS EMPTY

1. Monitor Commands

1-16

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

1-17

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

j :Display JP Number

all :Display all of NP Number and JP Number

1. Monitor Commands

1-18

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 NETWK SDATE JP# N O JOB-NAME S STIME PID AUX445I 1 A OLTM03 2005/01/28 1 A A OLTM0301 10:40:49 1776 AUX445I 2 A 2 A A OLTM0302 10:40:49 1856 AUX445I 3 A 3 A A OLTM0303 10:40:49 1732 AUX445I 7 A 7 A A OLTM0307 10:40:50 1872 AUX438I *** END OF ACTIVE NETWORK DISPLAY ***

1. Monitor Commands

1-19

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 the left of each message displayed.

Item Position Length Explanation

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 Name

S 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, n

According 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 SDATE TYPE ACTIVE-JOB# START-TIME AUX432I 1 A BSPSTA 2005/09/26 N 1 15:51:21 AUX438I *** END OF ACTIVE NETWORK DISPLAY ***

1. Monitor Commands

1-20

The explanation of items displayed (da, n)



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


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 57 8 Start time of Network

Display currently executing Jobs and the JP partitions that they execute in.

da,j

According 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 SDATE JOB S-TIME AUX434I 1 A BSPSTA 2005/09/26 BSPSTA02 AUX438I *** END OF ACTIVE NETWORK DISPLAY ***

The explanation of items displayed (da, j)



JP# 9 3 JP Number

C 13 1 Class of JP



JOB 38 8 Job Name

S-TIME 47 8 Start time of Job

1. Monitor Commands

1-21

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

yyyymmdd 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. Monitor Commands

1-22

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



S-DATE 9 10 Schedule Date

CL 20 1 Execution Class

NETWORKS 23,38,53 8 Network Name

32,47,62 1 Wait Condition (Hold wait) Alphanumeric character: A Hold Code character displayed in this

column 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. Monitor Commands

1-23

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

a Monitor command to display the information of Network Log File on the console. When the command is

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

termination information of Jobs that had ended.

AUX001I COMMAND VALID AUX414I *** DISPLAY LOG *** TIME=14:25:12 AUX415I JOBNAME NETWORK … SDATE RUN 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 0 0 ADMIN AUX416I BSPSTA02 BSPSTA … 2010/10/18 N 1425 1425 0 0 AUTOUSER AUX417I CURRENT LOG = NETWORK-LOG X, 0.75 PER CENT ALLOCATED AUX437I *** END OF NETWORK LOG DISPLAY ***

1. Monitor Commands

1-24




JOBNAME 9 8 Job Name


GROUPID 28 8 Network Group Name


RUN 50 1 Execution Type N: Normal Type R:Rerun 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. Monitor Commands

1-25

■ Display the information of Specific Network

(1) Function

Display the detailed attribute information such as Class, Job composition and so on, of a specific Network

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


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

Queue” (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


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 = 0000 END-DELAY = 0000 AUX709I START-INTERVAL = 0000 END-TIME = 0000 AUX709I RESOURCE = OFF PLUGIN(B) = OFF PLUGIN(A) = OFF AUX710I *** 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. Monitor Commands

1-26



Item Explanation

ATTRIBUTE Network Attributes HOLD(c): with Hold Attribute c: Hold Code TIME(hhmm): with Start Time Attribute hhmm: 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 Time

RESOURCE Resource using flag

PLUGIN(B) Plug-in Before Start flag

PLUGIN(A) Plug-in After start flag

1. Monitor Commands

1-27


JNO 9 3 Job Number


PRECEDING

JOB NO.

22 23 Preceding Job Numbers

ATTR 46 4 (Unused)

M-CD 51 4 Max Return Code


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


current 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 SDATE STATE 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 HELD AUX725I *** END OF NETWORK INFORMATION DISPLAY ***



Item Explanation

NETWORK

STATE

Current state of Network QUEUED : In Queue waiting for execution

1. Monitor Commands

1-28

Item Explanation

NOT CLEAR

ATTRIBUTE(S)

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


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 Ended NORMAL END(NEED MONITOR-ON) : Normally Ended

Monitor On wait condition is not cleared

ABNORMAL 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

CONSTRAINT

(*2)

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 )

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


current state of Network and Job.

1. Monitor Commands

1-29

AUX001I COMMAND VALID AUX706I *** NETWORK OLTM03 GENERAL DISPLAY *** TIME= 20:51:20 AUX971I NETWORK STATE : ACTIVE AUX972I JNO JOBNAME RC CODE REASON RSYSQ AUX973I 010 OLTM0301 04 JOB CANCELED AUX973I 020 OLTM0302 00 JOB WAS NOT EXECUTED AUX973I 030 OLTM0303 00 JOB TERMINATED AUX973I 040 OLTM0304 00 JOB WAS NOT EXECUTED AUX973I 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 TERMINATED AUX438I *** END OF ACTIVE NETWORK DISPLAY ***



Item Explanation

NETWORK

STATE

Network’s current State ACTIVE : running PAUSE : Suspended


JNO 9 3 Job Number


RC 22 2 Job End Return Code

CODE 25 4 Job End Code

REASON 30 26 Job State EXECUTE : Running JOB ABENDED :Abnormally ended JOB CANCELLED : Cancelled SCRIPT ERROR : Script error JOB TERMINATE : Normally ended PREVIOUS JOB ABENDED : Preceding Job abnormally ended JOB WAS NOT EXECUTED : Job was not executed FAILED TO LOGON : User failed to log-in JOB RECOVERY FAILED :Job failed to recover

RSYSQ 57 8 System Qualifier of Job

1. Monitor Commands

1-30

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 information

from the first file that has the Network.

Job Attribute : Information is usually obtained from Network Master.

1. Monitor Commands

1-31

■ 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


Operation Date and Time.

AUX001I COMMAND VALID AUX739I PDATE = 2004/05/20 TIME = 17:27:33

1. Monitor Commands

1-32

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 this

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


e.g.1-17 Operation Date Change 2

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


1. Monitor Commands

1-33

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 information of distribution candidates and

related information. Either 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 name

Register 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/off

on: Add Load Balance candidate in distribution target.

off: Remove Load Balance candidate from distribution target.

1. Monitor Commands

1-34

<3> u:reload or display Job Executing User information.

・u, list: Display user information from memory.

・u, reload: Reload userdef file.

1. Monitor Commands

1-35

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


information 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 RNAME RTYPE AUX079I LB02 A AUTO58 AS400 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 ***



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 Name

HOST IP Address and Host Name

PORT Port 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 Explanation

RNAME APLINK Name

RTYPE OS Type

1. Monitor Commands

1-36

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-COEFF Set Expression

1 fixed

INTVL Monitoring Interval(Time Interval to retrieve Load Information)

Unit: second

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 and

the processing of the Network is skipped.

[esys, l, sysgq=System Group Qualifier Name, lbsq= Candidate name of Load Balance, on(off)] is a

command 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. Monitor Commands

1-37

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



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

1-38

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

1-39

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


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

specified value.

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

Note




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

1-40

■ Change Attribute of Network Group

(1) Function

This is used to change Priority, Execution Class and Job Library ID of all Networks belonging to the

specified Network Group.

(2) Command Input

e, 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 of


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

specified value.

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

Note




1. Monitor Commands

1-41

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 the

following 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. Monitor Commands

1-42

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

from 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


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

1-43

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

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

the 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


Execution Class of JP from 1 to 10 is changed to C.

AUX001I COMMAND VALID AUX401I JP PARTITION 1 RESET AUX401I JP PARTITION 2 RESET AUX401I JP PARTITION 3 RESET AUX401I JP PARTITION 4 RESET AUX401I JP PARTITION 5 RESET AUX401I JP PARTITION 6 RESET AUX401I JP PARTITION 7 RESET AUX401I JP PARTITION 8 RESET AUX401I JP PARTITION 9 RESET AUX401I JP PARTITION 10 RESET

1. Monitor Commands

1-44

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

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

yyyymmdd 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


ANET0001 is Free On.

AUX001I COMMAND VALID AUX823I NETWORK ANET0001 SDATE=2004/01/12 IS FREE ON

1. Monitor Commands

1-45

e.g.1-25 Free Off a Network

Free Off ANET0002 (Network) by entering the following command.

fanet0002,off,sdate=040112


ANET0002 is Free Off.

AUX001I COMMAND VALID AUX823I NETWORK ANET0002 SDATE=2004/01/12 IS FREE OFF

1. Monitor Commands

1-46

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 : Specify the Network which was suspended by Stop Command.

e.g.1-26 Rerun the Network which was paused by Stop Command.

Resume the execution of ANET0001 (Network) which was suspended by entering the following command.

ganet0001


ANET0001 continues its execution.

AUX001I COMMAND VALID AUX412I NETWORK ANET0001 SDATE=2004/01/12 WILL GO AGAIN

1. Monitor Commands

1-47

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

1-48

■ 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, then

NP 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. Monitor Commands

1-49

■ 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, then

JP 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. Monitor Commands

1-50

■ 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


ANET0002 is held.

AUX001I COMMAND VALID AUX758I NETWORK ANET0002 SDATE=2004/01/12 IS HELD SUCCESSFULLY

1. Monitor Commands

1-51

■ 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. Monitor Commands

1-52

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 is

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

command, 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. Monitor Commands

1-53

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

1-54

■ 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 : Select the display type from the following options.

trace : Display the trace output level for each task.

dump : Display dump output level.

Example1-32 Display trace level

Enter the following command to display the current output level of the trace log.

ltrace

When A-AUTO Monitor receives this command, the following messages will be displayed. It displays the

output 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. Monitor Commands

1-55

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

command will not be changed.)

For task tmr, the change will be effective when tmr is next invoked by timer interval after you issued this

command.

(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. Monitor Commands

1-56

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

nep : 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. Monitor Commands

1-57

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 the

current 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. Monitor Commands

1-58

■ 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 : Specify the output level.

0 : Do not get dump log

1 : Only get dump log for error handling

2 : Get dump log for all error handling and some normal dump log.

3 : Get all dump log

Example1-34 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 the

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

Note

You cannot change the output level of dump log at task level.

1. Monitor Commands

1-59

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

content 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. Monitor Commands

1-60

e.g.1-36 Output queue buffer dump

: : : 20050207 121241 NCP: Q-BUFFER[19]------- 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.OLTM12 000010 20 20 00 00 00 4E 80 80 20 02 BA DC ...N.. ... 20050207 121241 NCP: Q-BUFFER-EX[19]------ 00 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 OLTM11 000010 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 000030 58 4D 4B 48 30 34 20 20 00 00 00 00 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 ................ 000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 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.OLTM13 000010 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.

Schedule Date Network ID

System Qualifier

Preceding Network ID

Class Priority

1. Monitor Commands

1-61

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

used 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

lswitch

Example1-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. Monitor Commands

1-62

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 in

environment 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 = S AUX122I 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 = 7000 MESSAGES_CIPMSID = 350 AUX122I MESSAGES_WAITTIME = 0 MSGLOG_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 = NWKSTK MAX_USERS = 1000 AUX122I AUTO_RJOB_RCVY = 0 AUTO_SESS_RCVY = 0 AUX122I NCP_NTWK_STOP = 0 AUX121I *** END OF PARAMETER DISPLAY ***

1. Monitor Commands

1-63

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 be

placed 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

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

e.g.1-39 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. Monitor Commands

1-64

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

1-65

1.3.14 Stop Command (P Command)

(1) Function

Stop command is used to temporarily suspend a Network that is executing. You can resume the

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

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

e.g.1-41 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. Monitor Commands

1-66

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 Network

of <1>, please specify this option.

If you do not specify this option, the default value

of 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. Monitor Commands

1-67

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

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

Start commands.

1. Monitor Commands

1-68

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 will

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

must be specified.

When a Network is started by A-AUTO for OS/400 Remote License or R/3 Job is included in this

Network, you cannot set a value out of 0 for it. If you set, an error message will be displayed, and

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

Start Command is executed successfully.

1. Monitor Commands

1-69

Example1-42 Start Network

Start ANET0001 (Network) for execution on A-AUTO Monitor.

sanet0001


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


be executed.


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.


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.


1. Monitor Commands

1-70

1.3.16 Tom Command (T Command)

(1) Function

Tom Command is used to display 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 of

yyyymmdd or yymmdd (Default: Operation Date)

<3>free=y : When you want to delete information of abnormally ended Network (Specify

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

is then added by Start Command. This Network will be executed as Normal type. In this case, the

preceding 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. Monitor Commands

1-71

Example1-46 Display ABEND Network

Display the information of ANET0001 (Network) in Abnormally Terminated Network File.

tanet0001,SDATE=111130,d

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

of 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. Monitor Commands

1-72

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 Queue

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

x

When 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. Monitor Commands

1-73

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 have

created 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. Monitor Commands

1-74

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 the

help.

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

When 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 Specify Network ID to be released Date Specify the schedule date of Network to be released in yyyymmdd format or yymmdd format (default : operation date)

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

2-8

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

commands 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

Command

Issuing commands in direct mode

icom∆01∆command


2-9

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

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

specified Agent is restarted or when v, restartd command is issued.

The settings in the Network Delay Monitor file defined by FSTFILE in registry,

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

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




Note

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

in Network Delay Monitor file.


specified Agent is restarted or when v, restartd command is issued.

The settings in the Network Delay Monitor file defined by FSTFILE in registry,


become effective when either the Agent is restarted or v, restartd command is issued.


2-11

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

retrieved from Master data if used in stand-alone mode.

The file number must be 00 in this case.




Note

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


specified Agent is restarted or when v, restartd command is issued. Network Delay Monitor file defined

by FSTFILE in registry,

\\HKEY_LOCAL_MACHINE\SOFTWARE\BSP\A-AUTOforWindowsNT\2.0\ASVSYSPARM\DELAY is

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

■ 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= time

Time

Specify the time interval in minutes.




Note

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


specified Agent is restarted or when v, restartd command is issued. The setting defined by INTERVAL

in registry


becomes effective when the Agent is restarted or when v, restartd command is issued.


2-13

■ 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

AY

This 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, f

command, or v, e, i command is issued → Issue v, restartd command.

② Input format

icom∆XX∆v, restartd




Note

When this command is issued, registry information and Network Delay Monitor file are reloaded and

settings defined in these files become effective.

Therefore, all modifications made by v, c, n command, v, e, n command, v, e, f command, and/or v, e,

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


2-14

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, conn, lb=Agent name

① Agent Name The name of the Agent to connect to

Agent 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 (00) APL250I SESSION TO (AGENT01 ) IS SUCCESSFULLY OPENED (00)


2-15

■ 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


①

(2) Forced disconnection

icom∆p, n, disce, lb=Agent name

① Agent Name The name of the Agent to disconnect


①

※ 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 (00) APL254I SESSION TO (AGENT01 ) IS SUCCESSFULLY DISCONNECTED (00) APL262I SESSION TO (AGENT01 ) IS SUCCESSFULLY CLOSED (00)


2-16

■ p, d, sess Command To view the information of a session

① Function

To display Session information.

② Input format

icom∆p, d, sess [, lb=Agent name]

① Agent Name The name of the Agent for which session information is to be displayed


①

③ Output Messages

Command input

icom p, d, sess, lb=AUTO01

Output message

APL204I AP-LINK V1.5.3 LV02 SESSION INFORMATION (01) APL350I COMMAND(P, D, SESS, LB=AUTO01) IS VALID (01) APL206I ID(00) NAME(AUTO01 ) NODE(VMXP-1) (01) APL207I STATUS(CONNECT 40) DRIVER(BSPTCPNT) BUFFSIZE(2048) (01)


2-17

■ 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, SDATE=yyyymmdd1yyyymmdd2, AGT=Agent Name, EID=Execution ID

① Schedule Date Specify the period (from schedule date & to schedule date) for File Transfer

operation. Networks and related information for the specified period are

transferred.

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 data

transferred by File Transfer. (Numbers 1 to 9, alphabets A to Z and “*” can be

used)

Omit this parameter if all Execution IDs are to be selected (i.e. do not select by

Execution ID).

*

③ Output Messages

This parameter is valid only for Agents on Mainframe.

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

■ STOPFTP Command Stop File Transfer Request to an agent

① Function

This command issues a request to cancel File Transfer to a specific Agent.

*

② Input format

This command is valid only for Agents on mainframe.

icom∆v, STOPFTP, AGT= ①

Agent Name

① Agent Name The agent name of the Agent whose File Transfer operation is to be

cancelled.


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

■ 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, AGT= ①

Agent Name

① Agent Name The name of the Agent whose Event monitoring is to be stopped.


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

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

■ 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 NAME STUATUS SVS137I AGENT01 DISCONNECT SVS137I AGENT02 CONNECT SVS137I AGENT03 FTP RUNNING SVS137I AGENT04 WATCHING SVS137I AGENT05 FTP RUNNING SVS139I *** DISPLAY END ***


2-22

■ 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

4. A-AUTO/Event commands

4-1

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 UNIX

icom∆r, command name

Example 4-1 START command

icom r,start

■ For Windows

r, command name

Example 4-2 START Command

r, start


4-2

4.1 Description of Commands for A-AUTO/Event

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

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

■ FIREEVENT Command

(1) Function

To make a specified Event occurred.

(2) Input Format

R,FIREEVENT,NAME=Event detection information ,TYPE=Event type, ① ② SITENAME=Computer name where the event occurs[,RES=Event occurrence information

③ ④

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

■ RELOAD Command

(1) Function

Retrieves trace option from XOPENSYS file.

(2) Input Format

R,RELOAD


4-6

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

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

■ 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 type ： Specify Event type.

J：Job Event

F：File Event

M：Message Event


4-9

■ RESET command

(1) Function

Stop All Event Monitor.

(2) Input Format

R,RESET


4-10

■ RELOAD Command

(1) Function

Trace Option Reload from XOPENSYS file.

(2) Input Format

R,RELOAD

5. Support Utilities

5-1

5.

Unless specifically stated in the description for each utility, support utilities are performed in the environment where the

A-AUTO monitor resides.

Support Utilities

■ 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

Note

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

(2) Command Input

Abasctl∆Type [∆KeyWord]

<1> <2>

<1> Type: 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.

abasctl abasinit

Shared Memory


5-2

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

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

value 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 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 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 :OK echo OK aexit 0 exit :NG echo NG aexit 10 exit


5-17

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

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

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

be specified depends on the autosmod functions (Add / Modify / Delete) requested as shown below.

Add Modify(Move) Delete

Card 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

mn

Size Type Explanation

A1

Information

classification

1 1 Letter

(fixed)

Specify "F".(Required)

A2

Processing

Type

2 1 Letter

Select one of the following

processing types. (Required)

A: Add

U: Modify(Move)

D: Delete

A3 Card NO 3 3 Number Specify a card number between 001 and 999. A set

of cards consisting of different card types may be

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

Card Type 0

No. Item Colu

mn


Common

Part

- - - Refer to common part

B1 Card ID 6 1 Numb

er

(Fixed

)

Specify " 0".(Required)

B2

Network

Name

7 1~

8

Letter

, Sign

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

specify the prefix network name. For prefix name, append "*"

at the end of the partial Network name. It is also possible to

specify only "*". If you specify only "*", the processing will

apply to all schedules.

B3

Change

Type

17 1 Letter

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

Specify 'R' in this item if the schedule date of selected

networks is to be moved (rescheduled). In this case, the

target schedule date of the selected networks is specified in

Processing 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

g Date1

18 6 Numb

er

Specify the date in the format yymmdd.

Must be specified.

B5

Processin

g Date2

24 6 Numb

er

For Processing Type 'U' (A2) with Change Type 'R' (B3), this

item specifies the new schedule date for the Networks. In

other cases, this item is optional and, when specified,

indicates the To Schedule Date in range specification. For

range specification, the From Schedule Date is specified in

Processing Date 1 (B4).

When left blank, Processing Date 1 item (B4) becomes a

specific schedule date instead of a range specification


5-20

No. Item Colu

mn


B6

Execution

ID

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

For Processing Type 'D' (A2), this item is used as an additional 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 name specified in the Network Name item (B2) and 'R' specified in the Change Type item (B3), this item is also used as an additional 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 not

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

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

No. Item Colu

mn


B8

Input

Data Wait

Attribute

32 1 Letter

,Sign

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


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 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 Input Data Wait attribute.

B9

Hold

Code

33 1 L&N,

Sign

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


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


Master.


5-22

No. Item Colu

mn


B10

Parallel

Run

Attribute

34 1 Letter

, Sign

P or - or blank can be specified.



added or updated.

P : Set Parallel Run attribute

- : Remove Parallel Run attribute


For Processing Type (A2) “A”, it gets the value from the

Parallel Run attribute of the Network defined in the Network

Master.

For Processing Type (A2) “U”, it gets the value from the

Parallel Run attribute of the Network defined in one of the


Network Master.

B11

System

Qualifier

35 8 L&N,

Sign

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


Specify the new System Qualifier for the Network Schedule to



System Qualifier attribute of the Network defined in the

Network Master.


System Qualifier attribute of the Network defined in one of the


Network Master.


5-23

No. Item Colu

mn


B12

Priority

43 2 Numb

er

You can set it to 01~15 or blank.


Specify the new Priority for the Network Schedule to be added

or updated. When left blank, the following applies.


Priority attribute of the Network defined in the Network Master.


Priority attribute of the Network defined in one of the following


Master.

B13

Start

Time

45 4 Numb

er

You can set it to 0001~4759 or 0000.


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


Master.

B14 Unused 49 1 - This item will be ignored.

B15

Process

Time

50 4 Numb

er

You can set it to 0000~9999.


Specify the new Processing Time for the Network Schedule to



Processing Time attribute of the Network defined in the

Network Master.


Processing Time attribute of the Network defined in one of the


Network Master.


5-24

No. Item Colu

mn


B16

Monitor

On

Attribute

54 1 Letter

You can set it to Y or N or blank.



added or updated.

Y : Set Monitor On attribute (Input Data Wait attribute must be

defined)

- : Remove Monitor On attribute



Monitor On attribute of the Network defined in the Network

Master.


Monitor On attribute of the Network defined in one of the


Network Master.

B17 Start

Delay

Watch

Time

55 4 Numb

er



Specify the new Start Delay Watch Time for the Network

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 Master

and Network Master.

The value of Start Delay Watch Time must be smaller than

End Delay Watch Time (B18).


5-25

No. Item Colu

mn


B18 End

Delay

Watch

Time

59 4 Numb

er



Specify the new End Delay Watch Time for the Network


0000 to remove End Delay Watch Time attribute. When left


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


and 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

er



Specify the new Time Interval End Time for the Network


0000 to remove Time Interval End Time attribute. When left


For Processing Type (A2) “A”, it gets the value from the Time

Interval End Time attribute of the Network defined in the

Network Master.

For Processing Type (A2) “U”, it gets the value from the Time

Interval End Time attribute of the Network defined in one of


and Network Master.

If a value is set for this item and Time Interval (B17) is set to

0, it will cause a run-time error.


5-26

No. Item Colu

mn


B20 Time

Interval

67 4 Numb

er

You can set it to 001~2879 minutes.


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 Time

Interval attribute of the Network defined in the Network

Master.

For Processing Type (A2) “U”, it gets the value from the Time

Interval attribute of the Network defined in one of the following


Master.

B21 Resource

s Use

Flag

71 1 L&N You can specify” I” or “–“ or blank.



added or updated.

I : Use Resource Management flag (Not valid for Processing

Type “A”.

- : Remove Resource Management flag



Resource Management attribute of the Network defined in the

Network Master.


Resource Management attribute of the Network defined in one

of the following Masters and in this order; Daily Network

Master and Network Master.


Network Master is defined with Resource Management

attribute.


5-27

No. Item Colu

mn


B22 Plug-in

Before

Start flag

72 1 Letter

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



added or updated.

I : Use Plug-in Before Start flag (Not valid for Processing Type

“A”.

- : Remove Plug-in Before Start flag



Plug-in Before Start attribute of the Network defined in the

Network Master.


Plug-in Before Start attribute of the Network defined in one of


and Network Master.


Network Master is defined with Plug-in Before Start attribute.

B23 Plug-in

After

Start Flag

73 1 Letter You can specify” I” or “–“ or blank.



added or updated.

I : Use Plug-in After Start flag (Not valid for Processing Type

“A”.

- : Remove Plug-in After Start flag



Plug-in After Start attribute of the Network defined in the

Network Master.


Plug-in After Start attribute of the Network defined in one of


and Network Master.


Network Master is defined with Plug-in After Start attribute.


5-28

No. Item Colu

mn


B24 Max

Executing

Time

74 4 Numb

er

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


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.


Maximum Executing Time attribute of the Network defined in

the Network Master.


Maximum Executing Time attribute of the Network defined in

one of the following Masters and in this order; Daily Network


If a value is set for this item, Response To Max Tme (B25)

must be set.

B25 Respons

e To Max

Time

78 1 Letter You can set it to ‘W’ or ‘C’.


This item is not valid if Max Executing Time (B24) is set to

0000.


added or updated.

W : Output a warning message.

C : Output a warning message and Cancel Cold is issued to

the executing Network.



Response To Max Tme attribute of the Network defined in the

Network Master.


Response To Max Tme attribute of the Network defined in one

of the following Masters and in this order; Daily Network



5-29

No. Item Colu

mn


B26 Job

Executing

User ID

79 8 L&N,

Sign

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


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


and Network Master.


5-30

Card Type 1

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

No. Item Colum

n


Common

Part


C1

Card ID 6 1 Number

(Fixing)

Specify “1”.( Required)

C2

Network

User Field

7 12 L&N, Sign A maximum of 12 alphanumeric characters can be

specified. Any characters exceeding 12 bytes are

truncated.

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



Network User Field attribute of the Network defined in

the Network Master.


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

mn


Common

Part


D1

Card ID 6 1 Number

(Fixing)

Specify “2”.( Required)


5-31

No. Item Colu

mn


D2

Precedenc

e Network

Change

Type

7 1 Letter Specify one of the following Preceding Network

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

to be applied. (Required)

R: Replace all the Preceding Network fields in the

selected Network Schedules with the Preceding

Networks specified in item (D4).

D: Delete all Preceding Network fields in the selected

Network Schedules. Items (D3) and (D4) are ignored.

U: Update Preceding Networks according to the

Preceding Network Change Sub-type item (D3).

D3

Precedenc

e Network

Change

Sub-type

8

19

30

41

1 Letter This item can be specified only when the Preceding

Network Change Type (D2) is 'U'.

Each D3 item indicates the action to be taken for the

corresponding Preceding Network item (D4).

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 the

Preceding Network field that matches the Preceding

Network item (D4).

D4

Preceding

Network

9

20

31

42

Less

than

eight

L&N The name of the preceding Network to change is

specified.

*[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 050417 A |

FA0020TES 050417 A |

FA0030TEST 050417 A |

(c)*** NO SYNTAX ERROR ***


5-32

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

Master Access Result List

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


DATE 2005/01/01 TIME 06:13:17

PROOF LIST OF DNTWKLIB ACCESS INQUIRY

(a) (b) (c) (d) (e)

SCHEDULE NETWORK ACCESS RESULT

19990101 OLTM01 ADD OK (SCHEMSTR ONLY)

20000101 OLTM02 ADD NG (SCHEMSTR ONLY)


DATE 2005/01/01 TIME 06:36:54

PROOF LIST OF MONTHLY SCHEDULE INQUIRY

(a) (b) (c) (d) (e) (f) (g) (h) (i) (j) (k)

SCHEDULE NETWORK NETWORK-EXPANDED EX ATTR CLS SYSTEM PRTY START

MAXIMUM EXECUTION

DATE NAME NAME ID QUALIFIER TIME EXECUTION TIME

USER ID


5-34

Sub-schedule Master Detail List

(a) Scheduled Date

(b) Network Name

(c) Network Expanded Name

(d) Execution ID

(e) Start Time

(f) Network Attribute

(g) Class


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


5-35

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

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

blanks.


5-36

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

Note

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

run the search queue XQ command.

(2) Command Input

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

<1> Mode: Select one of the following processing to be performed.

Delete, del, DELETE, DEL……Delete

freeon, on. FREEON, ON……..Free-On

freeoff, off, FREEOFF, OFF…..Free-Off

<2> Network: 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 and

processing is terminated. To specify network prefix for Delete mode, append an “*” to the

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

terminated.

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

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

from Network Queue File, Network Tom File, and Checkpoint File.

<3> Sort conditions: 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.

<4> Output Detail: 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-38

e.g.5-5 chkl 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 START END 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 START END ATTR RC STATUS AFDL01 111130 111129 000000/000000 000000/000000 00 NORMAL <<< QUEUING DATA -- NETWORK QUEUE FILE >>> SDATE CLASS PRTY STATUS Q-TYPE ATTR SYSQ QTIME LID 111130 A 6 00 N 0000 0 BSPEND 111130 111129 000000/000000 000000/000000 00 NORMAL <<< QUEUING DATA -- NETWORK QUEUE FILE >>> SDATE CLASS PRTY STATUS Q-TYPE ATTR SYSQ QTIME LID 111130 A 6 00 N 0000 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 START END STATUS1 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 START END STATUS1 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-39

Descriptions of items

If AUTO_LOGTIMEON is set to “1” in the Windows version, note that additional information (about 26 columns) will be

appended to the left of each message displayed.

◆ –o option is not specified

Item Position Size Explanation


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



CLASS 19 1 Class

PRTY 24 2 Priority

STATUS 30 2 Status

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


<<<ACTIVE DATA – NCBPREFIX>>>



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


5-40


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.


<<< ABNORMAL DATA -- NETWORK TOM FILE >>>



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


ACT-CNT 71 2 Invalid



5-42

■ 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 NETWORK N-STT DSFLAG F-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 NETWORK N-STT DSFLAG F-STT ON-DATE ON-TIME 001 BSPEND 0 DATA6 0 ******** ***** 002 BSPSTA 0 DATA1 0 ******** ***** DATA2 0 ******** ***** ****** END OF PRINT ******

Note

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


5-43

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

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

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

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

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 NETWORK N-STT DSFLAG F-STT ON-DATE ON-TIME 001 BSPSTA 0 D 0 ******** ***** DS 1 11/11/30 13:57 DSI 0 ******** ***** ****** END OF PRINT ****** A-AUTO V7.2.2.00 PAGE 2 DATE:2011/11/30 TIME:14:03:57 (C)Copyright BSP INC. 1996 ******* DATASET FLAG STATUS LIST ****** OPERATION DATE:11/11/30 SEQ DSFLAG NETWORK NAME COMMENT 001 D BSPSTA 002 DS BSPSTA 003 DSI BSPSTA ****** END OF PRINT ******

Descriptions of the items

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


SEQ 2 3 Sequence Number


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


SEQ 2 3 Sequence Number

DSFLAG 8 8 Data Wait ID

NETWORK

NAME

19 8 Network Name

COMMENT 36 44 Comment Information


5-45

■ 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) (2)

(1) Type: Indicates ON or OFF setting of a Data Wait flag of a Data Wait ID.

n: Set Data Wait flag to ON i.e. arrived.

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

(2) Data: Specify the Data Wait ID whose Data Wait flag is to be set. Up to 8 Data Wait IDs can be

set, 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-46

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

that have been initialized.

(2) Command Input

esvcrt

e.g.5-9 esvcrt utility

% esvcrt ECU003I ESVCRT UTILITY IS TERMINATED ESVN SUCCESS( 29 )NG( 0 ) ESVJ SUCCESS( 51 )NG( 0 )

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 to

end. [cip da]

③ Stop the Application Monitoring from A-AUTO/Web Client. Then initialize the Job Information File and

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


5-47

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_d del %autodir%\auw_esvjfile_i del %autodir%\auw_esvjfile_d del %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. [cip aq]


5-48

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

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

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

size.

Before Execution After Execution (Backup File)

aux_esvjfile_d

aux_esvjfile_i

aux_esvnfile_d

aux_esvnfile_i

aux_esvjfileback_d

aux_esvjfileback_i

aux_esvnfileback_d

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.

A-AUTO for UNIX

(2) Sample asvsfin shell script (UNIX) / Batch file (Windows)

#!/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 ← Add crtaja -rfin_temp2 exit 0


5-49

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

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

esvdel ∆-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 of

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

for "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-51

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

deleted.

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

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

be 256 bytes.

<3> Input and output file: Input and output file name is specified.

e.g.5-14 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 20 000060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 000070 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 000080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ・・


5-54

Record length for file

The record length for main files to be dumped are shown below..

File Name File Type (*) Size

Network master netwklib 800

Input data wait management master dsflagtb 192

Holiday master hldymstr 640

Schedule master schemstr 540

Daily Network master dntwklib 400

Cross-Master Network master pntwklib 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-55

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

unload a Master file to a sequential file.

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.

Load

Unload

Network Master Schedule Master

Holiday Master

form

SEQ File

Input Data Wait Master

Select Master


5-56

(2) Command Input

form ∆-Type ∆-t Select Master [∆ Input and Output File] [∆ -b]

<1> <2> <3> <4>

<1> Type: 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 file

An index file and a data file are created and initialized, and the 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-57

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

name 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 Stock evmtckpt 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.)

afilever File 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 the

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

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

status "Editing"


5-58

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

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

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

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

predefined 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's

Operation 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: Specify the file name of a backup file that is to be used as input file.

<3> all: This is specified if both Network Log and a backup file are to be used as input.

<4> Job Name: 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-61

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

e.g.5-17 log0 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 V7.2.2.00 PAGE 1 DATE:2011/11/30 TIME:16:04:59 (C)Copyright BSP INC. 1994 ******* NETWORK LOG LIST ****** OPERATION DATE:11/11/30 NETWORK GROUPID JOBNAME RC CODE C T ST-DATE START END ELAPSE CPU SDATE LID RSYSQ USER-ID BSPSTA GRP01 BSPSTA01 00 A N 11/11/30 160320 160330 0.10 0.000 11/11/30 0 AUTOUSR BSPSTA GRP01 BSPSTA02 00 A N 11/11/30 160330 160330 0.00 0.000 11/11/30 0 AUTOUSR OLTM01 GRP01 OLTM0101 00 A N 11/11/30 160341 160351 0.10 0.030 11/11/30 0 ****** END OF PRINT ******


5-63

Column and item description

If AUTO_LOGTIMEON is set to “1” In the Windows version, note that additional information (26 columns) will be

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



GROUPID 11 8 Network Group Name



CODE 32 4 Job End Code

C 37 1 OS Execution Class (Unused)

T 39 1 Execution Type N: Normal Type R: Rerun 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.

CPU time (sec)

SDATE 80 8 Schedule Date. YY/MM/DD


RSYSQ 94 8 System Qualifier Name


CODE Explanation

CODE displayed in the list comes from either one of the two sources. The first source is the exit code that

the 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 *2 *3

A-AUTO for Windows

V722Lv00 or later

― ―

A-AUTO for UNIX ― ―

A-REMOTE for Windows v4.0.0Lv14 or later Up to v4.0.0Lv13

A-REMOTE for UNIX v5007a or later Up to v5006a


5-64

★:*Only 1

CODE Problem generating

*1 *2 *3 Meaning A-A

UTO

M

onitor

A-R

EM

OTE

for U

NIX

A-R

EM

OTE

for W

indows

A-R

EM

OTE

for S

ystem i

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

0002 0002 0002 Error in connection with the remote point. armtux/armtnt has been started , please check that it is the communication state is able to communicate.

● ●

0003 0003 0003 Error in transmission of the job activation demand at the remote point. Please check that it is in the state where communication can have a good understanding.

● ●

0004 0004 0003

Error in reception processing of the notification of job end from the remote side. [KeepAlive Function] is not used. Please check that it is in the state where communication can have a good understanding.

● ●

0005 0005 0003

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 a communicative state. Moreover, please check whether armtux/armtnt is completed or not.

● ●

0006 0006 0003

[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 have a good understanding.

● ●

0007 0007 0007

[KeepAlive Function] is used. Since there was no transmission from the remote side after a specified time of KEEPALIVE use, it treats it as a loss in communication and carries out abnormal end treatment for the job. Please check that it is in the state where communication can have a good understanding.

● ●

0008 0008 0003

[KeepAlive Function] is used. Error in reception processing of the notification of Job end. Please check that it is in the state where communication can have a good understanding.

● ●

0009 0009 0003 KeepAlive Function] is used. The TCP/IP session was lost during reception processing of the notification of Job end. Please check a communicative state. Moreover, please check whether armtux/armtnt is completed or not.

● ●

0010 0010 0004 Failed to set the process of waiting when an error occurs.

Note error message and contact our support team. ● ●

0011 Non Non Since the information on the remote job for recovery does not exist in a job execution status file, abnormal end treatment of the job is carried out. Please check whether A-REMOTE is already restarted.

● ●

0020 0020 Non execscr failed in the generation of the job process. Please check that the job file and the shell script have “execute” authority. ●

0021 0021 0100 Error in execution of the job. There is a possibility that there was insufficient memory or the maximum number of the processes specified by the user is reached.

●

0022 Non Non There was error in the logon using the specified Job Executing User ID. Please check whether user ID and password are correctly defined in the User Information Definition file (userdef).

★ ● ●

0030 0030 0004

Error in generation of the rmtscr process by armtux. There is a possibility that there was no “execute” authority in rmtscr, there was insufficient memory, or the maximum number of the processes specified by the user is reached.

● ★

0031 0031 Non At the remote point, rmtscr failed in generation of the job execution process. There is a possibility that there was insufficient memory or the maximum number of the processes specified by the user is reached. ● ★

0032 0032 0100 The job could not be executed at the remote point. Please check that the shell script has “execute” authority. ● ★


5-65

CODE Problem generating

*1 *2 *3 Meaning A-A

UTO

M

onitor

A-R

EM

OTE

for U

NIX

A-R

EM

OTE

for W

indows

A-R

EM

OTE

for S

ystem i

0033 0033 Non

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 the job is not performed, when this message was displayed, A-REMOTE for UNIX might not be completed normally last time, but the shared memory may have remained. Please reboot armtux.

● ★

0034 Non Non Error in starting Job at the remote point. The information on JP division or the job information on relevance might have been unable to acquire at the remote point.

● ●

Non 0040 Non Error in generation of the thread for registration of a cancellation command.

Note error message and contact our support team. ●

Non 0041 Non Error in generation of the job execution process at the remote point. Please check that the job file has “execute” authority. ●

Non 0042 Non The job execution thread for cancellation was not found. There is a possibility that the job has already completed at the remote side. ●

0050 0050 0001 Error in transmission of the job activation demand to jslinkrj from an execscr process. Please check that AP-LINK of A-AUTO Monitor side is started, and jslinkrj has started normally.

●

0051 0051 0002

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

Function

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

to retry specified in

environment variable RJ_MAX_CONN_REQ. Please check that the remote job start function (System i) has started.

●

0052 0052 0003

Error in transmitting processing of the job activation demand from jslinkrj at the remote point. 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-66

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

can

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

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

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

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

contains 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 created prior

to executing this utility.

(2) Command Input

mkusrdef ∆-iInput File Name [∆-u]

<1> <2>

<1> Input File Name 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-97

(3) Input File Format

Input File Format as the following.

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.

# Item Name Need Size Explanation

1 Job Executing User ID ○ 1~8 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 32 Specify domain of the user.

3 User ID ○ 1~20 Specify actual User ID to execute Job.

4 User Password 20 Specify password of the user (Will be

Encrypted by the utility).

5 Comment 144 Specify comment for the user。


5-98

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

each page break, set -pi.


5-99

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 ANET01 06 ---- 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 BNET01 06 ---- 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-100

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)





■ Network’s Valid Date


1 11 Valid Date (Eyyyy/mm/dd) of Network

■ Network Information


1 8 Network Name

11 20 Network Comment

32 2 Priority

36 5 Start Time

42 1 Hold Code

43 1 Input Data Wait Attribute

44 1 Job Parallel Run


5-101

45 1 Monitor On Attribute

48 12 User Information

62 8 System Qualifier

71 1 Network ■Class

73 (75) 5 Execution Time (m)

■ Preceding Network Information *Up to 2 lines of Preceding Networks may be displayed depending on number of

preceding Networks (maximum 16).


1 8 Preceding Network Name

11 (10) 8 Preceding Network Name







■ Network Information 2


1 4 Max Executing Time

6 1 Response To Max Time

11 8 Job Executing User ID

21 4 Start Delay Watch Time

28 4 End Delay Watch Time

35 4 Interval

42 4 Time Interval End Time

51 3 Resource Flag

60 3 Plug-in Before Start Flag

67 3 Plug-in After Start Flag

■ Job Information


1 3 Job Number

6 8 Job Name

16 3 Preceding Job Number





5-102



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

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

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

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 related

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

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

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


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


RESID 1 8 Resource ID

RESNAME 10 20 Resource Name

MAX-P 31 5 Resource Max Usage

REMAIN 37 5 Number of Resources Remaining

TYPE 44 1 Resource Type (Resource target)

N: Network

J: Job

NETWORK 49 8 Network ID

JOBNUM 58 3 Job Number

JOB 65 8 Job Name

USE-P 74 5 Resource Usage

RELEASE 80 6 Resource Release Type

MANUAL: 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-122

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

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

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 0 breaksw default: echo ">> dntwklib Remake FAILED ($STATUS) " exit 1 endsw

e.g. 5-17 rmakdnwk utility Output Result

RDN001I RMAKDNWK STARTS RDN002I RMAKDNWK NOMAL END


5-127

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

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

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

Network has been created, the Network Schedule is not automatically updated to

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

Expiry Date. You may then confirm whether the changes to Network Schedules are

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

Explanation Items

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


1 8 Network

18 1 The 1st

21

of specified month by parameter.

1 The 2nd

24


1 The 3rd

27


1 The 4th

30


1 The 5th

33


1 The 6th

36


1 The 7th

39


1 The 8th

42


1 The 9th

45


1 The 10th

48


1 The 11st

51


1 The 12th

54


1 The 13th

57


1 The 14th

60


1 The 15th

63


1 The 16th

66


1 The 17th

69


1 The 18th

72


1 The 19th

75


1 The 20th

78


1 The 21st

81


1 The 22nd

84


1 The 23rd

87


1 The 24th

90


1 The 25th

93


1 The 26th

96


1 The 27th

99


1 The 28th

102


1 The 29th

105


1 The 30th

108


1 The 31st

* If the month does not have 29

of specified month by parameter. th, 30th and 31st, also display the header in 31 days.


5-129

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

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

neither 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 START END-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-130


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


SDATE 1 6 Schedule Date of Abend Network

NETWORK 8 8 Abend Network Name

GROUPID 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 R: Rerun Type

ST 41 2 End 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. YYMMDD/hhmmdd

END-T 61 6 CPU Time when Job End. hhmmdd

REASON 68 26 Job Status

JOB ABENDED: Abnormally Ended

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

JOB RECOVERY FAILED: Failed to Recover.


７. Remote Job Execute Function Utility

7-1

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 a

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

of 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 0 exit : NG echo NG aexit 10 exit

７. Remote Job Execute Function Utility

7-2

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

(2) Usual case

Return Code of armtntje will be the Return Code of initiating program.

(3) With armtntje

Initiate

A-REMOTE for Windows

JOBLOOP

JOB001

echo ### START JOB ###

rem jobloop never stop !!!

jobloop.bat

･･･

JOB001.bat

When A-Remote cancels JOB001, JOBLOOP is not canceled.

Initiate

A-REMOTE for Windows

JOBLOOP

JOB002

echo ### START JOB ###

rem jobloop never stop !!!

armtntje jobloop.bat

･･･

JOB002.bat

armtntje

When A-Remote cancels JOB002, JOBLOOP is also canceled.