Alex de Apg-40

NOT AN OFFICIAL TEST DOCUMENT
INTERNAL USE ONLY 1 (147)

Prepared (also subject responsible if other) No.
ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

Mario Gapari +385 (0)91 365 43 74 Date Rev Reference
Please let me know about any incorrect data in document.
16/11/2017 R1
Alphabetical list of APG40 commands click on command to see

parameter description
acease - AP Alarms Ceasing

aehevls - AP, Application, System and SecurityLog, List
aehls - AP, EventLog, List
afpchd - Adjunct Processor File Processing, File Definition, Change
afpdef - Adjunct Processor File Processing, File, Define
afpfte - Adjunct Processor File Processing, Manual Transfer, End
afpfti - Adjunct Processor File Processing, Manual Transfer, Initiate
afpls - Adjunct Processor File Processing, Files, List
afprm - Adjunct Processor File Processing, File, Delete
aldblk - Alarm-Display, Block
alddeblk - Alarm-Display, Deblock
alddef - Alarm-Display Data, Define
aldls - Alarm-Display Data, List
aldpdef - Alarm-Display Property, Define
aldpls - Alarm-Display Properties, List
aldprm - Alarm-Display Property, Delete
aldquiet - Alarm-Display, Quiet
aldrm - Alarm-Display Data, Delete
aldtest - Alarm-Display, Test
alist - AP Alarms Listing
alogact - Audit Log, Activate
alogdeact - Audit Log, Deactivate
alogexcl - Audit Log Exclusion, Insert or End
alogexls - Audit Log, Excluded Items, List
alogfind - Audit Log, Search
aloglist - Audit Log Attributes, List
alogset - Audit Log, Set Attributes
burbackup - AP, Backup, Initiate
burrestore - AP, Restore, Initiate
burverify - AP, Backup, Verify
cchres - Configuration Change Restore
cdhch - Common Destination Handling, Destination, Change
cdhdef - Common Destination Handling, Destination, Define
cdhdsch - Common Destination Handling, Destination Set, Change
cdhdsdef - Common Destination Handling, Destination Set, Define
cdhdsls - Common Destination Handling, Destination Set, List
cdhdsrm - Common Destination Handling, Destination Set, Delete
cdhdssw - Common Destination Handling, Destination Set, Switch
cdhls - Common Destination Handling, Destination, List
cdhrm - Common Destination Handling, Destination, Delete
cdhver - Common Destination Handling, Destination Connection, Verify
clhls - Central Log Handler, Log, List

16/11/2017 R1
clhtran - Central Log Handler, Log, Transfer

cluster - options for cluster command
cpdchange - IO Device in CP, Attributes, Change
cpdinsert - IO Device in CP, Insert
cpdlist - IO Device in CP, Attributes, List
cpdremove - IO Device in CP, Remove
cpdtest - IO Device in CP, Test
cpfchange - Central Processor File System, File Attributes, Change
cpfcp - Central Processor File System, File, Copy
cpfdf - Central Processor File System, Volumes, List
cpfife - Central Processor File System, Infinite File, End
cpfls - Central Processor File System, Files, List
cpfmkfile - Central Processor File System, File, Create
cpfmv - Central Processor File System, File, Move
cpfport - Central Processor File System, File, Transfer
cpfrename - Central Processor File System, File, Rename
cpfrm - Central Processor File System, File, Delete
cuadef - Central Processor User Association, Define
cuals - Central Processor User Association, List
cuarm - Central Processor User Association, Remove
dboch - Direct Block Output, Transfer Queue Definition, Change
dbodef - Direct Block Output, Transfer Queue, Define
dbols - Direct Block Output, Transfer Queue Definition, List
dborm - Direct Block Output, Transfer Queue, Delete
dform - Direct File Output, File, Delete
dsdls - Directory Service Listing
exalblk - External Alarm Receiver, Block
exalch - External Alarm Receiver Data, Change
exalclear - External Alarm Receiver, Manually Clear
exaldeblk - External Alarm Receiver, Deblock
exaldef - External Alarm Receiver Data, Define
exalls - External Alarm Receiver Data, List
exalrm - External Alarm Receiver Data, Delete
fcc commands
fchcommit - Function Change Commit
fchdump - Function Change, Dump
fchend - Function Change End
fchevent - Function Change, Event
fchfb - Function Change, Fallback
fchrst - Function Change, Restore
fchstart - Function Change, Start
fchstate - Function Change, State
fosarchive - Flexible Formatter, Archive
foscopy - Flexible Formatter, Copy
foscpio - Flexible Formatter, Cpio Archive
foslview - Flexible Formatter, View Unprocessed Data Log

16/11/2017 R1
fosview - Flexible Formatter, View System Information

ftpcreate - Ftp Create
ftpls - Ftp List
ftprm - Ftp Remove
hostname - host name resolution description
hwifetch - Node Position, Fetch
hwils - Node Position, List
hwiset - Node Position, Set
IntegrityAP - Integrity Verification
ipnaadm - IPNA Administration
ispprint - ISP Print Tool
mktr - Make Trouble Report
mml - Man-Machine Language, Commands, Execute
msdls - Message Store Listing
mtzln - Multiple Time Zone Link
nsfreset - AP, Network Surveillance, Reset
nsfstart - AP, Network Surveillance, Start
nsfstop - AP, Network Surveillance, Stop
ntbackup - Backup drives / folders to tape
phabup - Parameter Handling, Backup
phacreate - Parameter Handling, Create
phaedit - Parameter Handling, Edit
phaprint - Parameter Handling, Print
pharm - Parameter Handling, Remove
pharst - Parameter Handling, Restore
phatrans - Parameter Handling, Transfer
prcboot - Process Control, Reboot
prcconf - Process Control, Cluster Configuration
prcgen - Process Control, Configuration File, Generate
prcstate - Process Control, Determine State
rtrch - Record Transfer, Change
rtrdef - Record Transfer, Define
rtrls - Record Transfer, List
rtrrm - Record Transfer, Remove
sadfsconf - System Analysis Daemon FileSystem Configuration
seccease - AP Security Cease Defined Alarm
seccheck - AP Security Full Check
seclogfind - AP Security Find In Log File
secmlmnt - AP Security Monitoring List, Maintain
sfcend - Soft Function Change, End
sfcexec - Soft Function Change, Execute
sfcfb - Soft Function Change, Fallback
sfcsudo - Soft Function Change Set user
sll - System Log Listing
spchange - Site Parameter Change
stmcc - Statistics and Traffic Measurement, Counter Collection

16/11/2017 R1
stmdbrt - Statistics and Traffic Measurement, Database Retainment Time

stmfo - Statistics and Traffic Measurement, File Output
stmfols - Statistics and Traffic Measurement, Output Requests List
stmmp - Statistics and Traffic Measurement, Measuring Program
stmotd - Statistics and Traffic Measurement, Object Type Configuration
stmotls - Statistics and Traffic Measurement, Configuration and Status, List
stmrp - Statistics and Traffic Measurement, Report
stmttu - Statistics and Traffic Measurement, Translation Tables Update
swlist - Software List
SwManage - Software Manage
swrprint - Software Records, Print
swrprod - Software Records, Specify, Change and Retrieve Third Party Products
Identity
swrsid - Software Records, Change or Retrieve the Name of AP System
trainit - Initialize Memory for ACS Trace Function
trautil - Operators Interface to the ACS Trace Function
tzls - Time Zone List
UserDump - User Information
vdcreate - Virtual Directory Create
vdls - Virtual Directory List
vdrm - Virtual Directory Remove
Usefull links for commands description and APG40 guides

LAZY DOCUMENTS
http://www-rdc.etc.ericsson.se/organization/o/ot/stp/APGbuild/40/Lazy.htm
APG40 OVERWIEV AND USEFULL LINKS

http://unix.epa.ericsson.se/~epadnb/APG40/index.html
http://pingal.ericsson.se/ngs3.2_ph2/apg40-deliv.html
COMMANDS LIST AND DESCRIPTION

http://unix.epa.ericsson.se/~epadnb/APG40/ManualPages/Ingo2/index.html
http://unix.epa.ericsson.se/~epadnb/APG40/CommandExamples/Ingo3/ManualPages/index.ht
ml
http://unix.epa.ericsson.se/~epadnb/APG40/CommandExamples/Ingo4/ManualPages/index.ht
ml
ALEX DATABASES
http://cpi.al.sw.ericsson.se/alex
http://pingal.ericsson.se/cgi-bin/alex
ftp://pingal.ericsson.se/pub/alex/

16/11/2017 R1
afpchd - Adjunct Processor File Processing, File Definition,

Change
1 Format
afpchd [ -b yes|no][ -d removedelay ][ -r retries][ -s defaultstatus]
[ -t retryinterval] transferqueue destinationset
2 Parameters
2.1 Options
-b Countdown before status DELETE (this option specifies when the remove timer
starts counting)
Use one of the following values:
yes
Countdown directly when file or directory is reported. If the status is not DELETE
when the timer reaches zero (0), the file or directory is not deleted until the
status is changed to DELETE.
no
Countdown when status is changed to DELETE.
-d removedelay
Remove delay
This option specifies the delay in minutes for deletion of the file or directory. If
this option is omitted, remove delay is set to the default value. If minus one (-1)
is specified, no remove delay is defined for the file or directory. Consequently,
minus one ( -1) is not regarded as an actual remove delay value. It is instead
used for disabling the automatic deletion of the file or directory.
Signed integer -1 59999 (The default value is 10)
-r retries
Send retries
This option specifies how many times AFP should retry to send the file or directory
to the destination set if the transfer fails. If this option is omitted, or if zero (0) is
specified, AFP only tries to send the file or directory once with no retries. If minus
one (-1) is specified, AFP tries to send the file or directory infinitely.
Signed integer -1 - 100 (Default value is 0)
-s defaultstatus
Default status
This option specifies the default status of the file or directory.
DELETE
Delete file or directory

16/11/2017 R1
If the file or directory status is DELETE, the file or directory is deleted in the file
system when the remove delay time has reached zero (0).
NONE
No status
No processing occurs until the default status is set to another value on the file or
directory.
PENDING
Pending status
No processing occurs until the default status is set to another value on the file or
directory.
READY
Ready for transfer
The file or directory is transferred to the defined destination set.
-t retryinterval
Retry interval
This option specifies the delay in seconds between each retry to send the file or
directory in case of failure. Signed integer 10 - 59999 (The default value is 10)
2.1.1 Operands
destinationset
Destination set name
This operand specifies the name of the destination set in Common Destination
Handling (CDH). The operand is not case sensitive. Identifier 1 - 32 characters
transferqueue
Transfer queue name
This operand specifies the name of the transfer queue. The operand is not case
sensitive. Identifier 1 - 32 characters
afpdef - Adjunct Processor File Processing, File, Define
1 Format
afpdef [ -b yes|no][ -d removedelay ][ -g template [-j rename]]
[ -n nametag][ -r retries ][ -s defaultstatus][ -t retryinterval]
[ -v usergroup ][ -w sourcedirectory] transferqueue destinationset
2 Parameters
2.1 Options
-b Countdown before status DELETE


16/11/2017 R1
This option specifies when the remove timer starts counting. Use one of the
following values:
yes
Countdown directly when file or directory is reported. If the status is not DELETE
when the timer reaches zero (0), the file or directory is not deleted until the
status is changed to DELETE.
no
Countdown when status is changed to DELETE.
-d removedelay
Remove delay
This option specifies the delay in minutes for deletion of the file or directory. If
this option is omitted, remove delay is set to the default value. If minus one (-1)
is specified, no remove delay is defined for the file or directory. Consequently,
minus one (-1) is not regarded as an actual remove delay value. It is instead used
to disable the automatic deletion of the file or directory.
Signed integer -1 59999 (The default value is 10)
-g template
Rename template
This option specifies the template which is used to generate the new file or
directory name. The file template contains one or more of the following elements
in any sequence:
Each element may only be used once. Only one of yyyy and yy can be used. Only
one of nnnn, n, pppp and p can be used. The template is case sensitive.
yyyy - This element will give year in four digits
yy - This element will give year in two digits
mm - This element will give month
dd - This element will give day
HH - This element will give hour
MM - This element will give minute
SS - This element will give second
nnnn - This element will give transient sequence number with fixed length (range
0000 - 9999)
n - This element will give transient sequence number with flexible length (range 0
- 9999)
pppp - This element will give persistent sequence number with fixed length
(range 0000 - 9999)
p - This element will give persistent sequence number with flexible length (range
0 - 9999)
z - This element will give the logical file size in integer Kbytes
f - This element will give the file or directory name received from the application
F - This element will insert a name tag, specified with option -n nametag, on each
file or directory
-j rename
Rename file
This option specifies whether the file or directory is renamed directly when
reported to AFP or when the file or directory is transferred to the destination set.
This option is only valid when a rename template is specified. Use one of the
following values:
local
Local - The file or directory is renamed directly when reported to AFP.

16/11/2017 R1
remote
Remote - The file or directory is renamed when the file or directory is sent to the
destination set. (The default value is remote)
-n nametag
Name tag
This option specifies a name tag for identifying files or directories. If this option is
omitted, no name tag will be set on files or directories.
-r retries
Send retries
This option specifies how many times AFP should retry to send the file or directory
to the destination set if the transfer fails. If this option is omitted, or if zero (0) is
specified, AFP only tries to send the file or directory once with no retries. If minus
one (-1) is specified, AFP tries to send the file or directory infinitely.
Signed integer -1 - 100 (The default value is 0)
-s defaultstatus
Default status
This option specifies the default status of the transfer queue. This status is
inherited by the files or directories reported to the transfer queue. Use one of the
following values:
DELETE
Delete file or directory - If the file or directory status is DELETE, the file or
directory is deleted in the file system when the remove delay time has reached
zero (0).
NONE
No status - No processing occurs until the default status is set to another value
on the file or directory.
PENDING
Pending status - No processing occurs until the default status is set to another
value on the file or directory.
READY
Ready for transfer - The file or directory is transferred to the defined destination set.
(The default value is READY)
-t retryinterval
Retry interval
This option specifies the delay in seconds between each retry to send the file or
directory in case of failure. Signed integer 10 59999 (The default value is 10)
-v usergroup
User group name
This option specifies the name of the local user group whose members are allowed
to modify the transfer queue parameters or to delete the transfer queue or to
initiate manual transfer of files or directories.
-w sourcedirectory
Source directory name
This option specifies the source directory where an application must store the files
or directories that are to be reported to AFP. Identifier 1 - 255 characters
2.1.1 Operands
destinationset

16/11/2017 R1

This operand specifies the name of the destination set in CDH. The operand is not
case sensitive. Identifier 1 - 32 characters
transferqueue
Transfer queue name
afprm - Adjunct Processor File Processing, File, Delete
1 Format
afprm [ -c file -z directory ] transferqueue [destinationset]
2 Parameters
2.1 Options
-c file
File name
This option specifies the name of the file that is to be deleted. The argument is
not case sensitive. Text string 1 - 255 characters
-z directory
Directory name
This option specifies the name of a directory in the AFP function that is to be
deleted. The argument is not case sensitive. Text string 1 - 255 characters
2.1.1 Operands
destinationset
This operand specifies the name of the destination set in CDH. The argument is
not case sensitive. Identifier 1 - 32 characters
transferqueue
Transfer queue name

16/11/2017 R1
afpls - Adjunct Processor File Processing, Files, List
1 Format
afpls [ -l][ -s][ transferqueue [destinationset] ]
afpls -l [ -q][ -s][ transferqueue [destinationset] ]
afpls -o -y [ -l] transferqueue destinationset
afpls -l -o -y [ -q] transferqueue destinationset
afpls -a [ -q] transferqueue destinationset
2 Parameters
2.1 Options
-a List attributes
This option specifies that all attributes (default status, remove before, remove
delay, number of retries, retry interval, manual transfer, template, rename type
and source directory) for a transfer queue are printed.
-l Long list
This option specifies that a long list with all file attributes (remove delay, remove
timer, default status, destination set and source directory) is printed.
-o List the first reported file or directory
This option specifies that the first reported file or directory in a transfer queue is
listed.
-q Quiet printout
This option specifies that the printout headings are suppressed.
-s List all files or directories
This option specifies that all reported files or directories in a transfer queue are
listed.
-y List the last reported file or directory
This option specifies that the last reported file or directory in a transfer queue is
listed.
2.1.1 Operands
destinationset
transferqueue
Transfer queue name

16/11/2017 R1
afpfte - Adjunct Processor File Processing, Manual Transfer,

End
1 Format
afpfte -c file -z directory transferqueue destinationset
2 Parameters
2.1 Options
-c file
File name
This option specifies the name of a file, without path, to be transferred by the AFP
function. The argument is not case sensitive. Text string 1 - 255 characters
-z directory
Directory name
This option specifies the name of a directory, without path, to be transferred by
the AFP function. The argument is not case sensitive. Text string 1 - 255
characters
2.1.1 Operands
destinationset
Destination name
transferqueue
Transfer queue name

16/11/2017 R1
afpfti - Adjunct Processor File Processing, Manual Transfer,

Initiate
1 Format
afpfti -c file -z directory transferqueue destinationset
afpfti -c file -z directory [ -v usergroup] transferqueue destinationset
afpfti -f transferqueue destinationset [newdestinationset]
afpfti -f transferqueue
2 Parameters
2.1 Options
-c file
File name
This option specifies the name of a file to be transferred by the AFP function.
Argument file is an absolute path to the file, including the file name. If no
absolute path is supplied with the file, the current working directory is used as
absolute path. The argument is not case sensitive. Text string 1 - 255 characters
-f Transfer failed
This option specifies that the files or directories in status FAILED should be
transferred.
-v usergroup
User group name
to modify the transfer queue parameters or to delete the transfer queue or to
initiate manual transfer of files or directories.
-z directory
Directory name
This option specifies the name of a directory to be transferred by the AFP function.
Argument directory is an absolute path to the directory, including the file name. If
no absolute path is supplied with the directory, the current working directory is
used as absolute path. The argument is not case sensitive. Text string 1 - 255
characters
2.1.1 Operands
destinationset
Handling (CDH). The operand is not case sensitive. Identifier 1 - 32 characters
transferqueue
Transfer queue name

16/11/2017 R1
newdestinationset
New destination set name
This operand specifies a new destination set name for transferring of files or
directories that are in status FAILED. The operand is not case sensitive.
Identifier 1 - 32 characters
alddef - Alarm-Display Data, Define
1 Format
alddef [ -i information ][ - l lampprop][ -s soundprop][ -S] ald
alddef -p port1 [ -i information] ald
alddef -a address - p port2 [ -i information][ -l lampprop][ -s soundprop]
[ -S] ald
2 Parameters
2.1 Options
-a address
Internet destination
This option specifies the Internet Protocol (IP) address of a destination exchange.
This is a 32-bit address written in dotted-decimal notation, one for each byte of
the address. The argument is expressed as a.b.c.d
-i information
Information string
This option can be used to give further information about the alarm-display, such
as the source of the alarms or where the alarm-display is located. If there are
spaces in the slogan, quotation marks must be used. Text string 1 - 72 characters
-l lampprop
Lamp property
This option specifies the lamp property of the alarm-display. If omitted the default
property number zero (0) will be used. Signed integer 1 - 15
-p port1
Port number
This option specifies the port number on the local host, where the specified alarm-
display listens for an incoming connection in order to receive alarm-status from
another exchange. Signed integer 1 - 65535
-p port2

16/11/2017 R1
Port number
This option specifies the port number at the destination exchange with the
specified IP address, where the alarm-display listens. Must be specified when
option -a is specified. Signed integer 1 - 65535
-s soundprop
Sound property
This option specifies the sound property of the alarm-display. If omitted the
default property number zero (0) will be used. Signed integer 1 - 15
-S
Source of alarm-status
This option specifies the source of the alarm-status for this alarm-display. When
specified, the alarm-status of the standby side of the Central Processor (CP) is
shown on the alarm-display. If omitted, the alarm-status of the executive side of
the CP is shown.
2.1.1 Operands
ald Alarm-display
This operand specifies the name of the alarm-display.
The argument is expressed as ald-n where:
n Alarm display number. Signed integer 1 - 127
When assigning alarm-display numbers, the interval 1-31 is used for alarm-
displays that are connected to the exchange currently logged on to (first and
second format). Interval 32-127 is used when defining an alarm-display that
sends the alarm status to a destination host (third format).
aldrm - Alarm-Display Data, Delete
1 Format
aldrm ald
2 Parameters
2.1 Operands
ald
Alarm-display
Expressed as ald-n where:
n Alarm-display number. Signed integer 1 - 127

16/11/2017 R1
aldls - Alarm-Display Data, List
1 Format
aldls
2 Parameters
-
aldpls - Alarm-Display Properties, List
1 Format
aldpls
2 Parameters
-
aldpdef - Alarm-Display Property, Define
1 Format
aldpdef -l lampprop [ -1 alcat][ -2 alcat][ -3 alcat][ -4 alcat]
aldpdef -s soundprop [ -a sd][ -b sd][ -c sd][ -d sd][ -e sd ]
2 Parameters

16/11/2017 R1
2.1 Options
-1 alcat
Alarm category
This option specifies which alarm categories that are mapped towards alarm-
display category one (1). If omitted, no alarm categories are specified for this
alarm-display category. The argument is expressed as n[,n][..n] where:
n Signed integer 0 - 15
-2 alcat
Alarm category
display category two (2). If omitted, no alarm categories are specified for this
-3 alcat
Alarm category
display category three (3). If omitted, no alarm categories are specified for this
-4 alcat
Alarm category
display category four (4). If omitted, no alarm categories are specified for this
-a sd
Sound duration
This option specifies duration of the sound, in minutes, for the alarms with alarm
class zero (0), which is the highest severity. If omitted, no inhibition is done until
the alarm ceases or the sound is manually inhibited. Signed integer 0 - 59
-b sd
Sound duration
class one (1). If omitted, no inhibition is done until the alarm ceases or the sound
is manually inhibited. Signed integer 0 - 59
-c sd
Sound duration
class two (2). If omitted, no inhibition is done until the alarm ceases or the sound
is manually inhibited. Signed integer 0 - 59
-d sd
Sound duration
class three (3). If omitted, no inhibition is done until the alarm ceases or the
sound is manually inhibited. Signed integer 0 - 59
-e sd

16/11/2017 R1
Sound duration
class four (4), which is the lowest severity. If omitted, no inhibition is done until
the alarm ceases or the sound is manually inhibited. Signed integer 0 - 59
-l lampprop
Lamp property
This option specifies the lamp property to be defined. Signed integer 1 - 15
-s soundprop
Sound property
This option specifies the sound property to be defined. Signed integer 1 - 15
aldprm - Alarm-Display Property, Delete
1 Format
aldprm -l lampprop
aldprm -s soundprop
2 Parameters
2.1 Options
-l lampprop
Lamp property
This option specifies the lamp property to be deleted. Signed integer 1 - 15
-s soundprop
Sound property
This option specifies the sound property to be deleted. Signed integer 1 - 15
aldblk - Alarm-Display, Block
1 Format
aldblk ald
2 Parameters

16/11/2017 R1
2.1 Operands
ald
Alarm-display
alddeblk - Alarm-Display, Deblock
1 Format
alddeblk ald
2 Parameters
2.1 Operands
ald Alarm-display
aldquiet - Alarm-Display, Quiet
1 Format
aldquiet ald
2 Parameters
2.1 Operands

16/11/2017 R1
ald Alarm-display
aldtest - Alarm-Display, Test
1 Format
aldtest [ -b][ -e] ald
2 Parameters
2.1 Options
-b Begin test
This option starts the test of the specified alarm-display.
-e End test
This option ends a previously started test of the specified alarm-display.
2.1.1 Operands
ald Alarm-display
acease - AP Alarms Ceasing
1 Format
acease specificProblem:indexNumber
2 Parameters
2.1 Operands

16/11/2017 R1
specificProblem:indexNumber
Alarm Identifier
This operand is the identifier of the alarm that the operator wants to cease. It is
composed by specificProblem and indexNumber separated by a colon character.
specificProblem identifies the type of the alarm. Numeral 0 - 2147483647
indexNumber is a progressive number. It is used to distinguish different alarms
with the same specificProblem.
Numeral 0 - maximal number of alarms in alarm list
alist - AP Alarms Listing
1 Format
alist [ -r][ -i specificProblem[:indexNumber] ][ -s alarmClass]
[ -x probableCause][numberOfAlarms ]
2 Parameters
2.1 Options
-r Reverse
This option is used to list the alarms in reverse order, that is, the most recent
alarm is listed first.
-i specificProblem[:indexNumber]
Alarm identity
This option select the alarms that matches the indicated specificProblem. It can
further restrict the selected alarms to those that also matches the indexNumber.
When both option arguments are utilized, they must be separated by a colon
character.
specificProblem identifies the type of the alarm. Numeral 0 - 2147483647
indexNumber is a progressive number. It is used to distinguish different alarms
with the same specificProblem.
Numeral 0 - maximal number of alarms in alarm list
-s alarmClass
Alarm Class
This option selects the alarms with the severity of the reporting object according
to AXE alarm standard, (A1, A2, A3, O1, O2, or CEASING).
-x probableCause
Probable Cause

16/11/2017 R1
This option is used to request a printout of the alarms that matches the probable
cause. This parameter must be a single word or a qouted string.
2.1.1 Operands
numberOfAlarms
Number of alarms
The maximum number of alarms to be displayed. If the operand is omitted all
alarms are displayed. Numeral 0 - 99999
aehevls - AP, Application, System and SecurityLog, List
1 Format
aehevls [ -a user][ -c source][ -t startdate][ -u starttime][ -x stopdate]
[ -y stoptime][ -l logtype][ -n yes/no][ -m number][ -T tracefile ]
2 Parameters
2.1 Options
-a user
If specified, search for events matching this user parametervalue. If not specified
all users are selected. Wildcard '*' can be used.
-c source
If specified, search for events matching this source parametervalue. If not
specified all sources are selected. Wildcard '*' can be used.
-t startdate
If set, search for events with date greater or equal to this date, format
YYYYMMDD or YYMMDD. If not set todays date is used. If only YY then it is
replaced by 19YY if YY is greater or equal to 70, else 20YY.
-u starttime
If set, search for events with date and time greater or equal to this time and
startdate, format HHMM. Starttime = <actual time - 1 hour> if not set and
startdate is not set (if stoptime is between 00:00 and 01:00 then starttime is set
to 0000. Starttime = 0000 if not set and startdate is set.
-x stopdate
If set, search for events with date less or equal to this date, format YYYYMMDD or
YYMMDD. If not set todays date is used. If only YY then it is replaced by 19YY if
YY is greater or equal to 70, else 20YY.

16/11/2017 R1
-y stoptime
If set, search for events with date and time less or equal to this time and
stopdate, format HHMM. Stoptime= <actual time> if not set and stopdate is not
set. Stoptime = 2359 if not set and stopdate is set.
-l logtype
Which EventLog to read, logtype must be 'app' for reading ApplicationLog, 'sys' for
reading SystemLog or 'sec' for reading SecurityLog. If not set the ApplicationLog
will be read.
-n yes/no
Just count events, if '-n yes' (selected and total). Selects events according to
other given parameters and parametervalues. The total is a count of all events in
the EventLog, including the selected ones. Displays the message "Number of
events: selected=nn total=mm". The events themselves are not displayed. If this
parameter is set to '-n yes' then parameter -m is ignored. Default is '-n no'.
-m number
Maximum number of events to display, default is 100. Number must be numeric
and in the interval 1-999.999.999. If more events are selected than this number,
they are not displayed and the message "More events to show" is displayed after
the last displayed event. This parameter is ignored if '-n yes' is set.
-T tracefile
Can be used to trace the program, traces are written to tracefile. This is not
intended to be used by an ordinary user.
burbackup - AP, Backup, Initiate
1 Format
burbackup
burbackup -src Source_Directory -dest Destination_Directory
burbackup -src Source_Directory -imgdest Destination_File
burbackup -imgsrc Source_File -dest Destination_Directory
burbackup -savedatadiskinfo Destination_File
burbackup -restoredatadiskinfo Source_File
2 Parameters
2.1 Options
-src Source_Directory
Source
This option allows the user to specify the directory from where to start the
backup.
-imgsrc Source_File
Image source

16/11/2017 R1
This option allows the user to specify the source file.

-dest Destination_Directory
Destination
This option allows the user to specify the destination directory.
-imgdest Destination_File
Image destination
This option allows the user to specify the destination file.
-savedatadiskinfo Destination_File
Save datadisk info
This option allows the user to save the partition and directory structure of the
datadisks.
-restoredatadiskinfo Source_File
Restore datadisk directory and partition structure
WARNING
This option allows the user to restore the partition and directory structure of the
datadisks. All data on the datadisks will be deleted.This option shall only be used
when performing a Disaster Recovery.
burverify - AP, Backup, Verify
1 Format
burverify -d [filename]
burverify -i filename
2 Parameters
2.1 Options
-d [filename]
Display
This option displays information about backup on the backup partition or a backup
image file.
-i filename
Integrity
This option will perform an integrity check of a backup image file.
2.1.1 Operands
filename
Filename
This operand specifies the path and name to the backup image file.

16/11/2017 R1
aehls - AP, EventLog, List
1 Format
aehls [ -b probableCause ][ -d objectClassOfReference]
[ -e specificProblem][ -o objectOfReference][ -r processName]
[ -s perceivedSeverity][ -t startdate ][ -u starttime][ -x stopdate]
[ -y stoptime][ -n yes/no][ -m number][ -T tracefile]
2 Parameters
2.1 Options
-b probableCause
If specified, search for events matching this 'probableCause' parametervalue. If
not specified all 'probableCause's are selected. Wildcard can be used (see
description below).
-d objectClassOfReference
If specified, search for events matching this 'objectClassOfReference'
parametervalue. If not specified all 'objectClassOfReference's are selected.
Wildcard can be used (see description below).
-e specificProblem
If specified, search for events matching this 'specificProblem' parametervalue. If
not specified all 'specificProblem's are selected. Wildcard can be used (see
description below).
-o objectOfReference
If specified, search for events matching this 'objectOfReference' parametervalue.
If not specified all 'objectOfReference's are selected. Wildcard can be used (see
description below).
-r processName
If specified, search for events matching this 'processName' parametervalue. If not
specified all 'processName's are selected. Wildcard can be used (see description
below).
-s perceivedSeverity
If specified, search for events matching this 'perceivedSeverity' parametervalue.
If not specified all 'perceivedSeverity's are selected. Wildcard can be used (see
description below).
-t startdate
If set, search for events with date greater or equal to this date, format
YYYYMMDD or YYMMDD. If not set todays date is used. If only YY, then it is
replaced by 19YY if YY is greater or equal to 70, else 20YY.
-u starttime
If set, search for events with date and time greater or equal to this time and
startdate, format HHMM. Starttime = <actual time - 1 hour> if not set and
startdate is not set (if stoptime is between 00:00 and 01:00, then starttime is set
to 0000). Starttime = 0000 if not set and startdate is set.

16/11/2017 R1
-x stopdate
If set, search for events with date less or equal to this date, format YYYYMMDD or
YYMMDD. If not set todays date is used. If only YY, then it is replaced by 19YY if
YY is greater or equal to 70, else 20YY.
-y stoptime
If set, search for events with date and time less or equal to this time and
stopdate, format HHMM. stoptime = <actual time> if not set and stopdate is not
set. Stoptime = 2359 if not set and stopdate is set.
-n yes/no
Just count events, if '-n yes' (selected and total). Selects events according to
other given parameters and parametervalues. The total is a count of all events in
the EventLog, including the selected ones. Displays the message "Number of
events: selected=nn total=mm". The events themselves are not displayed. If this
parameter is set to '-n yes', then parameter -m is ignored. Default is '-n no'.
-m number
Maximum number of events to display, default is 100. Number must be numeric
and in the interval 1-999.999.999. If more events are selected than this number,
they are not displayed, and the message "More events to show" is displayed after
the last displayed event. This parameter is ignored if '-n yes' is set.
-T tracefile
Can be used to trace the program, traces are written to file tracefile. This is not
intended to be used by an ordinary user.
nsfreset - AP, Network Surveillance, Reset
1 Format
nsfreset
2 Parameters
-
nsfstart - AP, Network Surveillance, Start
1 Format
nsfstart

16/11/2017 R1
2 Parameters
-
nsfstop - AP, Network Surveillance, Stop
1 Format
nsfstop
2 Parameters
-
burrestore - AP, Restore, Initiate
1 Format
burrestore [ -stay]
2 Parameters
2.1 Options
-stay
Stay
This option allows the user to switch partitions without initiating a reboot.
aloglist - Audit Log Attributes, List
1 Format

16/11/2017 R1
aloglist
2 Parameters
-
alogexcl - Audit Log Exclusion, Insert or End
1 Format
alogexcl -t type -x|-e item [ -f]
2 Parameters
2.1 Options
-t type
Kind of item
This option specifies the kind of item whose status is to be changed either to
excluded or from excluded. Use one of the following values:
mc
Man Machine Language (MML) command
If mc is specified, an MML command is affected.
mp
MML printout
If mp is specified, an MML printout is affected.
mpa
MML command parameter
If mpa is specified, an MML command parameter is affected.
uc (only on APG30)
UNIX command
If uc is specified, a UNIX command is affected.
nc (only on APG40)
Windows NT commands
If nc is specified, Windows NT commands are affected.
np (only on APG40)

16/11/2017 R1
Windows NT printouts
If np is specified, Windows NT printouts are affected.
-x|-e Exclude or end exclusion

These options specify whether the status of the item is to be changed, to excluded
-x or from excluded -e.
-f APG40 only. Force insert or end exclusion of item in the Audit Log
Whenever possible, this option causes the command to run without prompting the
user, that is, silent.
2.1.1 Operands
item
Item to be excluded or ended from exclusion
This operand specifies the item whose status is to be changed.
alogact - Audit Log, Activate
1 Format
alogact
2 Parameters
-
alogdeact - Audit Log, Deactivate
1 Format
alogdeact [ -f]
2 Parameters
2.1 Options
-f APG40 only. Force Audit Log deactivation


16/11/2017 R1
alogexls - Audit Log, Excluded Items, List
1 Format
alogexls
2 Parameters
-
alogfind - Audit Log, Search
1 Format
alogfind [ -d device ][ -u user][ -a start_time -e start_date]
[ -b stop_time -g stop_date][ -e start_date][ -g stop_date ]
[ -l local_host][ -r remote_host][ -i session_id ][ -t type]
[ -s string]
2 Parameters
2.1 Options
-a start_time
Start time
This option specifies the start time, making it possible to limit the search range.
Expressed as hhmm where:
hh (Hours) Digit string 00 - 23
mm (Minutes) Digit string 00 - 59
-b stop_time
Stop time
This option specifies the stop time, making it possible to limit the search range.
hh(Hour) Digit string 00 - 23
mm(Minutes) Digit string 00 - 59
-d device
Input/Output (IO) device
This option makes it possible to search for an IO device. The option can be
specified as a single regular expression (Bourne Shell syntax on UNIX or DOS

16/11/2017 R1
syntax on NT). The regular expression must be within quotation marks to prevent
the shell from expanding it.
-e start_date
Start date
This option specifies the start date, making it possible to limit the search range.If
this option is not specified together with the -a option, the start date is set to 10
years before the actual day date. Expressed as yyyymmdd where:
yyyy (Year) Digit string 0000 - 9999
mm (Month) Digit string 01 - 12
dd (Day) Digit string 01 - 31
-g stop_date
Stop date
This option specifies the stop date, making it possible to limit the search range. If
this option is not specified together with the -b option, the stop date is set to the
actual day date. Expressed as yyyymmdd where:
yyyy (Year) Digit string 0000 - 9999
mm(Month) Digit string 01 - 12
dd (Day) Digit string 01 - 31
-i session_id
Session identification
This option makes it possible to search for a specific session identification. The
session identification is unique for each active session of an IO device. Digit string
-l local_host
Local host
This option makes it possible to search for a specific local host name. The option
can be specified as a single regular expression (Bourne Shell syntax on UNIX or
DOS syntax on NT). The regular expression must be within quotation marks to
prevent the shell from expanding it.
-r remote_host
Remote host
This option makes it possible to search for a specific remote hostname. The option
can be specified as a single regular expression (Bourne Shell syntax on UNIX or
DOS syntax on NT). The regular expression must be within quotation marks to
prevent the shell from expanding it.
-s string
Search string
This option makes it possible to search for a specific text-string in the text part of
the logged data. If no kind of item is specified in combination with this string, all
kinds of text in the text part are compared. The option can be specified as a single
regular expression (Bourne Shell syntax on UNIX or DOS syntax on NT). The
regular expression must be within quotation marks to prevent the shell from
expanding it.
-t type
Kind of item
This option specifies the kind of item to be searched for. The option can be
specified as a single regular expression (Bourne Shell syntax on UNIX or DOS
syntax on NT). The regular expression must be within quotation marks to prevent
the shell from expanding it.

16/11/2017 R1

alp
Alarm printouts
If alp is specified, alarm printouts are affected.
apd
Application data
If apd is specified, application data is affected.
mc
MML commands
If mc is specified, ManMachine Language (MML) commands are affected.
mp
MML printouts
If mp is specified, MML printouts are affected.
nc
Windows NT commands and processes
If nc is specified, Windows NT commands and processes are affected.
sec
Windows NT security Audit events
If sec is specified, Windows NT Security Audit events are affected.
-u user
Username
This option makes it possible to search for a user. The option can be specified as a
single regular expression (Bourne Shell syntax on UNIX or DOS syntax on NT).
The regular expression must be within quotation marks to prevent the shell from
expanding it.
alogset - Audit Log, Set Attributes
1 Format
alogset [ -s size][ -d transfer_queue][ -f]
2 Parameters
2.1 Options
-s size
Maximum size of log-file directory.
This option makes it possible to specify a new upper limit for the sum of all the
log-file size values. The limit must be specified in the range of 10 megabytes (Mb)
to 100 Mb. Only values divisible by 10 can be specified. The default value is 100
Mb. Numeral 10 - 100

16/11/2017 R1
Note: This option has no effect when a transfer queue is defined (-d option).
-d transfer_queue
Generic Output Handler transfer queue.
This option makes it possible to specify a new transfer queue for the Generic
Output Handling of the log-files generated by the Audit Log function. The
transfer_queue is specified as one string with a length of maximum 128
characters. If an empty string is specified surrounded by quotation marks, the
transfer queue will be defined to no transfer queue. The default value is an empty
string, i.e. no transfer queue.
-f force
Force changing of Audit Log attributes.
This option causes the command to run without prompting the user, that is, silent.
clhls - Central Log Handler, Log, List
1 Format
clhls [ -s cpside ][ -a start_time][ -e start_date][ -b stop_time ]
[ -f stop_date] [log ...]
clhls -d [ -e start_date] [ -f stop_date]
2 Parameters
2.1 Options
-a start_time
Start time
This option specifies the start time, making it possible to limit the time range. If
only start time and no start date is specified it is today's date that is used.
hh Hours Digit string 00 - 23
mm Minutes Digit string 00 - 59
-b stop_time
Stop time
This option specifies the stop time, making it possible to limit the time range. If
only stop time and no stop date is specified it is today's date that is used.
-d Specifies the "dir" option

16/11/2017 R1
This option specifies the facility of listing which logs have events registered in a
given period of time specified by the start_date and stop_date parameters. If no
events are registered, it's indicated by dashes.
If no start/stop date is defined a list of every log is printed.
-e start_date
Start date
This option specifies the start date, making it possible to limit the time range. If
only start date and no start time is specified it is the time from start of the day
that is used.
Expressed as yyyymmdd where:
yyyy Year Digit string 0000 - 9999
mm Month Digit string 01 - 12
dd Day Digit string 01 - 31
-f stop_date
Stop date
This option specifies the stop date, making it possible to limit the time range. If
only stop date and no stop time is specified it is the time from end of the day that
is used.
Expressed as yyyymmdd where:
-s cpside
CP side
This option specifies from which of the Central Processor (CP) sides the logs are
listed. If the option is omitted, the logs from both CP sides are listed.
Use one of following values:
cpa
CP side A - The logs from CP side A will be listed.
cpb
CP side B - The logs from CP side B will be listed.
2.1 Operands
log ...
CP log type
This operand specifies the type of the log. If the operand is omitted, all log types
are listed.
Use one or more of following values:
sys
Sys Log - The CP Sys Log has a time stamp set on on every Sys Log event.

16/11/2017 R1
event
Event Log - The CP Event Log has a time stamp set on on every Event Log event.
error
Error Log - The CP Error Log has a time stamp set on on every Error Log event.
clhtran - Central Log Handler, Log, Transfer
1 Format
clhtran [ -t ftp][ -a start_time][ -e start_date][ -b stop_time]
[ -f stop_date ] transferqueue log ...
clhtran -t dat [ -a start_time][ -e start_date][ -b stop_time]
[ -f stop_date ] log ...
2 Parameters
2.1 Options
-a start_time
Start time
This option specifies the start time, making it possible to limit the time range. If
only start time and no start date is specified it is today's date that is used.
-b stop_time
Stop time
This option specifies the stop time, making it possible to limit the time range. If
only stop time and no stop date is specified it is today's date that is used.
-e start_date
Start date
This option specifies the start date, making it possible to limit the time range. If
only start date and no start time is specified it is the time from start of the day
that is used. Expressed as yyyymmdd where:
-f stop_date

16/11/2017 R1
Stop date
This option specifies the stop date, making it possible to limit the time range. If
only stop date and no stop time is specified it is the time from end of the day that
is used. Expressed as yyyymmdd where:
-t Transfer type
This option specifies the transfer type.
Use one of following values:
ftp
File Transfer Protocol (FTP) - This is a protocol over TCP/IP.
dat
DAT tape - This is the DAT tape on the AP.
The default value is ftp.
2.1 Operands
log Central Processor (CP) log type

This operand specifies the type of the log.
Use one or more of following values:
sys
Sys Log - The CP Sys Log is stored in subfiles with time stamps included in the
subfile name.
event
Event Log - The CP Event Log is stored in subfiles with time stamps included in
the subfile name.
error
Error Log - The CP Error Log is stored in subfiles with time stamps included in the
subfile name.
bin
Bin Log - The CP Bin Log is stored in subfiles with time stamps included in the
subfile name.
core
Core Dump - The CP Core Dump is stored in a one file with a time stamp included
in the file name.
crash
Crash Dump - The CP Crash Dump files are stored in a directory. A time stamp is
included in the directory name.
transferqueue
Transfer queue name

16/11/2017 R1
cpfchange - Central Processor File System, File Attributes,

Change
1 Format
cpfchange -s maxsize | no file
cpfchange [ -s maxsize | no] -t maxtime | no file
cpfchange -r yes | no [ -s maxsize | no][ -t maxtime | no] file
cpfchange -d transferqueue -m mode [ -r yes | no][ -s maxsize | no]
[ -t maxtime | no] file
2 Parameters
2.1 Options
-d transferqueue
Transfer queue
This option specifies a transfer queue name for transferring data with GOH. This
option can only be used with data from infinite files. Identifier 1 - 32
-m mode
Transfer mode
This option specifies mode for data transfer in GOH. This option is only valid if a
transfer queue has been specified. Use one of the following values:
BLOCK
Block mode - Data will be transferred as blocks.
FILE
File mode - Data will be transferred as files.
NONE
Inhibit mode - No transfer will occur.
-r yes | no
Release condition
If yes is specified and the infinite file is closed a new active subfile is created. If
no is specified and the infinite file is closed and opened again, then the active
subfile will remain the same.
-s maxsize | no
Maximum size

16/11/2017 R1
This option specifies the maximum size of an infinite subfile, expressed in records.
When the file has reached the maximum size, a new active subfile is created and
the previous active subfile is closed. If no is specified, the infinite subfile does not
have a maximum size. Signed integer 1 - 9999999
-t maxtime | no
Maximum time
This option specifies the maximum active time for an infinite subfile, in minutes.
When the file has reached the maximum active time, a new active subfile is
created and the previous active subfile is closed. If no is specified, the infinite
subfile does not have a maximum time. Signed integer 1 - 9999999
2.1.1 Operands
file Central Processor (CP) file name

This operand specifies the CP file. This operand is not case sensitive.
cpfcp - Central Processor File System, File, Copy
1 Format
cpfcp [ -m mode] file1[-subfile1[-generation1]]
file2[-subfile2[-generation2]]
2 Parameters
2.1 Options
-m mode
Mode
This option specifies how files are copied. Use one of the following values:
over
Overwrite - An existing file is overwritten when a file is copied.
app
Append - Data is added to the end of an existing file when a file is copied.
clr
Clear - An existing file is overwritten when a file is copied. If the destination file is
a composite main file, all subfiles belonging to this file are deleted before the
source file is copied.

16/11/2017 R1
2.1.1 Operands
Source Central Processor (CP) file name
This operand specifies the source CP file. The first part indicates a simple file or a
composite main file. If the file name contains the optional second and third part, a
subfile is indicated. A subfile may only be specified if the main file is composite.
This operand is not case sensitive.
file1
Source file name - Identifier 1 - 12 characters
subfile1
Source subfile name - Symbolic name 1 - 12 characters
generation1
Source generation name - Symbolic name 1 - 8 characters
Destination CP file name
This operand specifies the destination CP file. The first part indicates a simple file
or a composite main file. If the file name contains the second part and an optional
third part, a composite subfile is indicated. A subfile may only be specified if the
main file is composite. This operand is not case sensitive. An infinite file may not
be specified as the destination.
file2
Destination file name - Identifier 1 - 12 characters
subfile2
Destination subfile name - Symbolic name 1 - 12 characters
generation2
Destination generation name - Symbolic name 1 - 8 characters
cpfmkfile - Central Processor File System, File, Create
1 Format
cpfmkfile [ -c][ -f reg] -l rlength file volume
cpfmkfile -f inf -l rlength [ -r][ -s maxsize][ -t maxtime] file volume
cpfmkfile -f inf -d transferqueue -l rlength [ -m mode][ -r][ -s maxsize]
[ -t maxtime ] file volume
cpfmkfile file-subfile[-generation]
2 Parameters
2.1 Options

16/11/2017 R1
-c Composite file
This option specifies a composite file.
-d transferqueue
Transfer queue
This option specifies a transfer queue name for transferring data with GOH. This
option can only be used with data from infinite files. Identifier 1 - 32
-f reg
Regular file
This option specifies a regular file. If the option is omitted, a regular file is
created.
-f inf
Infinite file
This option specifies an infinite file.
-l rlength
Record length
This option specifies the record length of the file, in octets.
Signed integer 1 - 65535
-m mode
Transfer mode
This option specifies mode for data transfer in GOH. This option is only valid if a
transfer queue has been specified. When a transfer queue is specified and this
option is omitted, the transfer queue will only be defined and no data transfer will
occur. Use one of the following values:
BLOCK
Block mode - Data will be transferred as blocks.
FILE
File mode - Data will be transferred as files.
NONE
Inhibit mode - No transfer will occur.
The default value is NONE.
-r Release condition for an infinite file
If the release condition is specified and the infinite file is closed, a new active
subfile is created. If the release condition is not specified and the infinite file is
closed and opened again, then the active subfile will remain the same.
-s maxsize
Maximum size
This option specifies the maximum size of an infinite subfile, expressed in records.
When the file has reached the maximum size, a new active subfile is created and
the previous active subfile is closed. Signed integer 1 - 9999999
-t maxtime
Maximum time
This option specifies the maximum active time for an infinite subfile, in minutes.
When the file has reached the maximum active time, a new active subfile is
created and the previous active subfile is closed. Signed integer 1 - 9999999
2.1.1 Operands
file
Central Processor (CP) file name

16/11/2017 R1
This operand specifies a CP file. The file name must begin with a letter. This
operand is not case sensitive.
volume
Volume name
This operand specifies the volume where the file is to be created. This operand is
not case sensitive.
Symbolic name 1 - 15 characters
file-subfile[-generation]
Subfile name
This operand specifies a subfile. The subfile name consists of three parts,
separated by hyphens. The first part must begin with a letter and indicates a
composite main file which must exist. The second part and the optional third part
indicate the subfile extension. This operand is not case sensitive.
file
File name - Identifier 1 - 12 characters
subfile
Subfile name - Symbolic name 1 - 12 characters
generation
Generation name - Symbolic name 1 - 8 characters
cpfrm - Central Processor File System, File, Delete
1 Format
cpfrm [ -r] file
cpfrm file-subfile[-generation]
2 Parameters
2.1 Options
-r Delete recursively
This option specifies that a composite file, including subfiles, will be deleted. If the
file is not composite, the option is ignored.
2.1.1 Operands

This operand specifies a CP file. This operand is not case sensitive.

16/11/2017 R1
Subfile name
This operand specifies a subfile. The subfile name consists of three parts,
separated by hyphens. The first part indicates a composite main file. The second
part and the optional third part indicate the subfile extension. This operand is not
case sensitive.
file
subfile
generation
cpfmv - Central Processor File System, File, Move
1 Format
cpfmv file volume
2 Parameters
2.1 Operands
file
volume
Volume name
This operand specifies the volume to which the file will be moved. This operand is
not case sensitive.
cpfrename - Central Processor File System, File, Rename
1 Format
cpfrename file1 file2
cpfrename file-subfile1[-generation1] file-subfile2[-generation2]

16/11/2017 R1
2 Parameters
2.1 Operands
file1 Old Central Processor (CP) file name

This operand specifies the old CP file. This operand is not case sensitive.
file2 New CP file name
This operand specifies the new CP file. The file name must begin with a letter. This
operand is not case sensitive. Identifier 1 - 12 characters
file-subfile1[-generation1]
Old subfile name
This operand specifies the old subfile. The subfile name consists of three parts,
separated by hyphens. The first part must begin with a letter and indicates a
composite main file. The second part and the optional third part indicates the
subfile extension. This operand is not case sensitive.
file
subfile1
Old subfile name - Symbolic name 1 - 12 characters
generation1
Old generation name - Symbolic name 1 - 8 characters
file-subfile2[-generation2]
New subfile name
This operand specifies the new subfile. The subfile name consists of three parts,
separated by dashes. The first part must begin with a letter and indicates a
composite main file. The second part and the optional third part indicates the
subfile extension. This operand is not case sensitive.
file
subfile2
New subfile name - Symbolic name 1 - 12 characters
generation2
New generation name - Symbolic name 1 - 8 characters
cpfport - Central Processor File System, File, Transfer
1 Format
cpfport -e [ -m mode] file[-subfile[-generation]] path
cpfport -i [ -m mode] path file[-subfile[-generation]]

16/11/2017 R1
2 Parameters
2.1 Options
-e Export
This option specifies that a Central Processor (CP) file is copied (exported) to the
Adjunct Processor (AP) native file system.
-i Import
This option specifies that a AP native file or directory is copied (imported) to a CP
file.
-m mode
Mode
This option specifies how files are copied. Use one of the following:
over
Overwrite - An existing file is overwritten when a file is copied.
app
Append - Data is added to the end of an existing file when a file is copied.
clr
Clear - This mode is only allowed for file import. An existing file is overwritten
when a file is copied. If the destination file is a composite main file, all subfiles
belonging to this file are deleted before the source file is copied.
2.1.1 Operands
file[-subfile[-generation]]
CP file name
This operand specifies the CP file. The first part indicates a simple file or a
composite main file. If the file name contains the second part and an optional
third part, a subfile is indicated. A subfile may only be specified for a composite
main file. This operand is not case sensitive.
file
subfile
generation
path Path name
This operand indicates the file or directory path in the AP native file system. This
cpfls - Central Processor File System, Files, List


16/11/2017 R1
1 Format
cpfls -p file [-subfile]
cpfls [ -l][ -q][ -s][file]
cpfls [ -l][ -q] file-subfile[-generation]
2 Parameters
2.1 Options
-l Long listing
This option is used to list additional file information.
-p Path listing
This option is used to list the physical path to a specific file.
-q Quiet listing
This option is used to suppress all headings.
-s Subfiles listing
This option is used to list all subfiles belonging to a composite file. The option is
ignored for simple files.
2.1.1 Operands
file
Subfile name
This operand specifies the subfile. The subfile name consists of three parts,
separated by hyphens. The first part indicates a composite main file. The second
part and the optional third part indicates the subfile extension. This operand is not
case sensitive.
file
subfile
generation

16/11/2017 R1
cpfife - Central Processor File System, Infinite File, End
1 Format
cpfife file
2 Parameters
2.1 Operands

cpfdf - Central Processor File System, Volumes, List
1 Format
cpfdf [ -q]
2 Parameters
2.1 Options
-q Quiet listing
This option is used to suppress all headings.
cuadef - Central Processor User Association, Define
1 Format
cuadef -g group -u cpuser [-c "comment"][-p position]
2 Parameters

16/11/2017 R1
2.1 Options
-c comment
Comment
This option defines a comment for the specified association. Text string 0 - 256
characters
-g group
AP group
This option defines an existing local group in the AP to the association. Text string
1 - 30 characters
-p position
Position
This option defines the position for the specified association. If the position is not
defined or is greater than the total number of associations, the new association
will automatically be defined in the next free position. Signed integer 1 - 999
-u cpuser
CP user code
This option defines a CP user code to the association. Text string 1 - 15 characters
cuals - Central Processor User Association, List
1 Format
cuals
2 Parameters
-
cuarm - Central Processor User Association, Remove
1 Format

16/11/2017 R1
cuarm -a
cuarm -g group
cuarm -u cpuser
2 Parameters
2.1 Options
-a All
This option deletes all associations.
-g group
AP group
This option deletes the association containing the specified AP group.
Text string 1 - 30 characters
-u cpuser
CP user code
This option deletes all associations containing the specified CP user code.
cdhver - Common Destination Handling, Destination

Connection, Verify
1 Format
cdhver [ -m] destination
2 Parameters
2.1 Options
-m Manual notification
This option is used to manually send a file notification to the remote system. The
notification is sent for the last not acknowledged file notification.

16/11/2017 R1
2.1.1 Operands
destination
Destination name
This operand specifies the name of the destination to be verified. The operand is
not case sensitive. The operand must begin with a letter. Identifier 1 - 32
characters
cdhdsch - Common Destination Handling, Destination Set,

Change
1 Format
cdhdsch -s secondarydestination | -b backupdestination | primarydestination
destinationset
cdhdsch -x destinationset
2 Parameters
2.1 Options
-b backupdestination
Backup destination name
This option specifies the name of the destination to be used as the backup
destination in the destination set. The option is not case sensitive.
-s secondarydestination
Secondary destination name
This option specifies the name of the destination to be used as the secondary
-x Swap primary and secondary destination
This option is used to swap the primary and secondary destination.
2.1.1 Operands
destinationset
This operand specifies the name of the destination set to be changed. The
primarydestination

16/11/2017 R1
Primary destination name

This operand specifies the name of the destination to be used as the primary
destination in the destination set. The operand is not case sensitive.
cdhdsdef - Common Destination Handling, Destination Set,

Define
1 Format
cdhdsdef [ -v usergroup ][ -s secondarydestination][ -b backupdestination]
primarydestination destinationset
2 Parameters
2.1 Options
-b backupdestination
Backup destination name
This option specifies the name of the destination to be used as the backup
-s secondarydestination
Secondary destination name
This option specifies the name of the destination to be used as the secondary
-v usergroup
User group name
to modify the destination set parameters or delete the destination set.
2.1.1 Operands
destinationset
This operand specifies the name of the destination set to be defined. The operand
is not case sensitive. The operand must begin with a letter. Identifier 1 - 32
characters
primarydestination
Primary destination name

16/11/2017 R1
This operand specifies the name of the destination to be used as the primary
destination in the destination set. The operand is not case sensitive.
cdhdsrm - Common Destination Handling, Destination Set,

Delete
1 Format
cdhdsrm [destination] destinationset
2 Parameters
2.1 Operands
destination
Destination name
This operand specifies the name of the destination to be deleted from the
destination set. The operand is not case sensitive. Identifier 1 - 32 characters
destinationset
This operand specifies the name of the destination set to be deleted or the name
of the destination set from which the destination shall be deleted. The operand is
cdhdsls - Common Destination Handling, Destination Set,

List
1 Format
cdhdsls [ -l] [destinationset]
2 Parameters
2.1 Options

16/11/2017 R1
-l Long format listing

This option specifies that all defined destinations of a given destination set, or all
destination sets, are to be listed.
2.1.1 Operands
destinationset
This operand specifies the name of the destination set to be listed. The operand is
cdhdssw - Common Destination Handling, Destination Set,

Switch
1 Format
cdhdssw destination destinationset
2 Parameters
2.1 Operands
destination
Destination name
This operand specifies the name of the destination. The operand is not case
destinationset
This operand specifies the name of the destination set. The operand is not case
cdhch - Common Destination Handling, Destination,

Change
1 Format
cdhch [ -a address ][ -s retries][ -m block_retrydelay] destination
cdhch [ -a address ][ -r remote_dir][ -n portnr][ -u user_name][ -p]
[ -o overwrite ][ -s retries][ -d file_retrydelay] destination

16/11/2017 R1
cdhch [ -o overwrite ] destination

cdhch [ -e event_type ][ -f address][ -o overwrite][ -x portnr]
[ -y response_time] destination
2 Parameters
2.1 Options
-a address
Remote system address
This option specifies the address of the remote system for the data to be sent to.
The argument can be an Internet Protocol (IP) address expressed as a.b.c.d
Or the argument can be a host name. Text string 1 - 30 characters
-d file_retrydelay
Retry delay for file transfer
This option specifies the delay in seconds between each retry to send a file or
directory in case of failure. This option is only valid for transfer types FTPV2 and
SFTPV2 with connection type i. Signed integer 1 - 60
-e event_type
Event type
This option specifies the type of event that is raised if the connection to the
remote system for file notification is lost. This option is only valid for transfer type
FTPV2, connection type r, and when the destination is defined with file
notification.
alarm
Alarm
Alarm DATA OUTPUT, AP COMMON DESTINATION HANDLING, DESTINATION
FAULT is raised if the connection is lost.
event
Event - An event is raised if the connection towards the remote system is lost.
-f address
Remote file notification address
This option specifies the address of the remote system for the file notification to
be sent to. This option is only valid for transfer type FTPV2 and connection type r.
-m block_retrydelay
Retry delay for block transfer
This option specifies the delay in milliseconds between each retry to send a block.
This option is only valid for transfer type BGWRPC. Signed integer 200 - 10 000
-n portnr
Port number

16/11/2017 R1
This option specifies the Transmission Control Protocol / Internet Protocol

(TCP/IP) port number on the remote system to connect to. This option is only
valid for transfer types FTPV2 and SFTPV2 when connection type i is used.
-o overwrite
Overwrite
This option specifies if an existing file at the destination is to be overwritten. This
option is only valid when sending single files with transfer types FTPV2 and
SFTPV2. This option has no effect when sending directories, as these are by
default always sent with the overwrite value no.
yes
Yes - If the file already exists at the destination, the file is overwritten.
no
No - If the file already exists at the destination, the file is not overwritten. The
new file is renamed with a time stamp.
-p Remote system password
This option specifies that a check printout should prompt for a password to be
sent to the remote system. This option is only valid for transfer types FTPV2 and
SFTPV2 when connection type i is used.
-r remote_dir
Remote directory
This option specifies the full path, including a directory separator at the end, to
the directory in the FTP area at the remote system where the sent data is to be
placed. This option is only valid for transfer types FTPV2 and SFTPV2. Connection
type i must be specified. Text string 1 - 256 characters
-s retries
Send retries
This option specifies how many times CDH should retry to send the block, file or
directory to the destination if the transfer fails. This option is only valid for
transfer types FTPV2 and SFTPV2 with connection type i and BGWRPC.
-u user_name
Remote system user name
This option specifies the user name that is sent to the remote system. This option
is only valid for transfer types FTPV2 and SFTPV2 when connection type i is used.
For transfer type FTPV2, option -u must be specified when a password is specified
and a user name has not been previously specified. Text string 1 - 128 characters
-x portnr
Port number
This option specifies the TCP/IP port number on the remote system to connect to.
This option is only valid for transfer type FTPV2 and connection type r when file
notification is used. Signed integer 0 - 65535
-y response_time
Response time
This option specifies the time in seconds to wait for a response from the remote
system when a file notification message is sent. This option is only valid for
transfer type FTPV2 and connection type r. Signed integer 10 - 10000

16/11/2017 R1
2.1.1 Operands
destination
Destination name
This operand specifies the name of the destination, whose attributes are to be
changed. The operand is not case sensitive. Identifier 1 - 32 characters
cdhdef - Common Destination Handling, Destination,

Define
1 Format
cdhdef -a address -t transtype [ -v usergroup][ -s retries]
[ -m block_retrydelay] destination
cdhdef -a address -t transtype [ -r remote_dir][ -n portnr][ -u user_name]
[ -p][ -c connect_type][ -o overwrite][ -v usergroup ][ -s retries]
[ -g suppress_create_subdir] [ -d file_retrydelay ] destination
cdhdef -a address -t transtype [ -r remote_dir][ -n portnr] -u user_name -p
[ -c connect_type][ -o overwrite][ -v usergroup ][ -s retries]
[ -g suppress_create_subdir][ -d file_retrydelay ] destination
cdhdef -t transtype -c connect_type [ -o overwrite][ -v usergroup ]
[ -g suppress_create_subdir][ -k remove_fileprefix ]
-h virtual_dir destination
cdhdef [ -e event_type ] -t transtype -c connect_type -f address
[ -o overwrite] -x portnr [ -y response_time][ -v usergroup ]
[ -g suppress_create_subdir][ -k remove_fileprefix ]
-h virtual_dir destination
2 Parameters
2.1 Options
-a address
Remote system address
This option specifies the address of the remote system for the data to be sent to.
-c connect_type
Connection type
This option specifies the type of connection to be used. For FTPV2, both
connection type i and connection type r may be specified. For transfer type
SFTPV2, only connection type i may be specified.

16/11/2017 R1

i
Initiating - Common Destination Handling (CDH) acts as an initiator and initiates
data transfer to the remote system.
r
Responding - CDH acts as a responder. The remote system initiates data transfer
to the remote system.
The default value is i.
-d file_retrydelay
Retry delay for file transfer
This option specifies the delay in seconds between each retry to send a file or
directory in case of failure. This option is only valid for transfer types FTPV2 and
SFTPV2 with connection type i. Signed integer 1 60. The default value is 10.
-e event_type
Event type
This option specifies the type of event that is raised if the connection to the
remote system for file notification is lost. This option is only valid for transfer type
FTPV2, connection type r, and when the destination is defined with file
notification.
alarm
Alarm
Alarm DATA OUTPUT, AP COMMON DESTINATION HANDLING, DESTINATION
FAULT is raised if the connection is lost.
event
Event - An event is raised if the connection towards the remote system is lost.
The default value is alarm.
-f address
Remote file notification address
This option specifies the address of the remote system for the file notification to
be sent to. This option is only valid for transfer type FTPV2 with connection type r.
The argument can be an IP address expressed as a.b.c.d
-g suppress_create_subdir
Suppress Subdirectory Creation
Connection type i: This option specifies if creation of a subdirectory with the
transfer queue name on the remote system in which data is to be stored shall be
suppressed. If not suppressed the subdirectory is added to the path specified with
the remote directory option. If the subdirectory does not exist, it will be created.
If the remote directory option is not specified, the subdirectory will be created in
the FTP root directory. This option is only valid for transfer type FTPV2 and
SFTPV2.
Connection type r: This option specifies if creation of a subdirectory with the
destination name on the FTP server in which data is to be stored shall be
suppressed. If not suppressed the subdirectory is added to the path specified with
the virtual directory option. If the subdirectory does not exist, it will be created.
This option is only valid for transfer type FTPV2.

16/11/2017 R1
yes
Yes - The creation of the subdirectory is suppressed and the directory will not be
created.
no
No - The creation of the subdirectory is not suppressed and the directory will be
created.
The default value is no.
-h virtual_dir
Virtual directory
This option specifies the name of the virtual directory which specifies the physical
path where the files or directories are to be stored. This option is only valid for
transfer type FTPV2 with connection type r.
-k remove_fileprefix
Remove Fileprefix from File and Directorynames
File transfer: This option specifies if the fileprefix with the tranfer queue name
shall be removed from the filenames of the files stored in the FTP area. This
option is only valid for transfer type FTPV2 with connection type r.
Directory transfer: This option specifies if the fileprefix with the tranfer queue
name shall be removed from the directorynames of the directories stored in the
FTP area. This option is only valid for transfer type FTPV2 with connection type r.
yes
Yes - The fileprefix with the transfer queue name is removed from the file- and
directorynames.
no
No - The fileprefix with the transfer queue name is maintained in the file- and
directorynames.
-m block_retrydelay
Retry delay for block transfer
This option specifies the delay in milliseconds between each retry to send a block.
This option is only valid for transfer type BGWRPC. Signed integer 200 - 10 000
The default value is 1000.
-n portnr
Port number
This option specifies the Transmission Control Protocol / Internet Protocol
(TCP/IP) port number on the remote system to connect to. This option is only
valid for transfer types FTPV2 and SFTPV2. Connection type i must be used.
Signed integer 0 65535.
The default value is 21 for FTPV2.
The default value is 22 for SFTPV2.
-o overwrite
Overwrite
This option specifies if an existing file at the destination is to be overwritten. This
option is only valid when sending single files with transfer types FTPV2 and

16/11/2017 R1
SFTPV2. This option has no effect when sending directories, as these are by
default always sent with the overwrite value no.
yes
Yes - If the file already exists at the destination, the file is overwritten.
no
No - If the file already exists at the destination, the file is not overwritten. The
new file is renamed with a time stamp.
-p Remote system password
This option specifies that a check printout should prompt for a password to be
sent to the remote system. This option is only valid for transfer types FTPV2 and
SFTPV2 when connection type i is used. For transfer type SFTPV2, option -p must
be specified.
-r remote_dir
Remote directory
This option specifies the full path, including a directory separator at the end, to
the directory in the FTP area at the remote system where the sent data is to be
placed. The directory must exist when the transfer starts. Text string 1 - 256
characters
-s retries
Send retries
This option specifies how many times CDH should retry to send the block, file or
directory to the destination if the transfer fails. This option is only valid for
transfer types FTPV2 and SFTPV2 with connection type i and BGWRPC. Signed
integer 0 100. The default value is 0.
-t transtype
Transfer type
This option specifies which type of transfer to be used.
BGWRPC
Billing Gateway (BGw) Remote Procedure Call (RPC) - This is an RPC protocol
over TCP/IP supported by BGw.
FTPV2
FTP Version 2 - FTPV2 is File Transfer Protocol (FTP) according to RFC 959
extended with most of the Common Charging Interface (CCI) requirements.
SFTPV2
SSH FTP Version 2 - SFTPV2 is the same as transfer type FTPV2 with Secure Shell
(SSH). This transfer type is only available with connection type i
-u user_name
Remote system user name
This option specifies the user name that is sent to the remote system. This option
is only valid for transfer types FTPV2 and SFTPV2 when connection type i is used.
For transfer type SFTPV2, option -u must be specified. For transfer type FTPV2,
option -u must be specified when a password is specified. Text string 1 - 128
characters. The default value is anonymous.
-v usergroup
User group name

16/11/2017 R1
to modify the destination parameters or delete the destination.
-x portnr
Port number
This option specifies the TCP/IP port number on the remote system to connect to.
This option is only valid for transfer type FTPV2 with connection type r when file
notification is used. Signed integer 0 - 65535
-y response_time
Response time
This option specifies the time in seconds to wait for a response from the remote
system when a file notification message is sent. This option is only valid for
transfer type FTPV2 with connection type r. Signed integer 10 10000. The
default value is 10 seconds.
2.1.1 Operands
destination
Destination name
This operand specifies the name of the destination to be defined. The operand is
not case sensitive. The operand must begin with a letter. Identifier 1 - 32
characters
cdhrm - Common Destination Handling, Destination,

Delete
1 Format
cdhrm destination
2 Parameters
2.1 Operands
destination
Destination name
This operand specifies the name of the destination to be deleted. The operand is
cdhls - Common Destination Handling, Destination, List


16/11/2017 R1
1 Format
cdhls [ -d -l] [destination]
cdhls -p destination
2 Parameters
2.1 Options
-d Destination set listing

This option specifies that the destination set to which a given destination or all
destinations belong are to be listed.
This option specifies that all defined parameters of a given destination or all
destinations are to be listed.
-p Path listing
This option specifies that the physical path to a specific destination is to be listed.
This option is only valid for destinations defined with transfer type FTPV2 and
connect type r.
2.1.1 Operands
destination
Destination name
This operand specifies the name of the destination to be listed. The operand is not

16/11/2017 R1
dboch - Direct Block Output, Transfer Queue Definition,

Change
1 Format
dboch -m yes [-r remove_delay] transferqueue [destinationset]
dboch [ -m no] transferqueue [destinationset]
2 Parameters
2.1 Options
-m Block mirroring
This option specifies if the mirroring function is to be used or not.
yes - Block mirroring is used
no - Block mirroring is not used
-r remove_delay
Remove delay
This option specifies the delay in minutes for deletion of the files where the
mirrored blocks are stored. This option is only valid when option -m is set to yes.
Signed Integer 1 10080. The default value is 1440.
2.1.1 Operands
transferqueue
Transfer queue name
This operand specifies the name of the transfer queue. Identifier 1 - 32 characters
destinationset
This option specifies the name of the destination set in Common Destination
Handling (CDH). Identifier 1 - 32 characters
dbols - Direct Block Output, Transfer Queue Definition, List
1 Format
dbols [ -l][transferqueue]

16/11/2017 R1
2 Parameters
2.1 Options

This option specifies that all defined parameters of a given transfer queue or all
transfer queues are to be listed.
2.1.1 Operands
transferqueue
Transfer queue name
dbodef - Direct Block Output, Transfer Queue, Define
1 Format
dbodef -m yes [-r remove_delay][ -v usergroup ] transferqueue
destinationset
dbodef [ -m no][ -v usergroup] transferqueue destinationset
2 Parameters
2.1 Options
-m Block mirroring
This option specifies if the mirroring function is to be used or not.
yes - Block mirroring is used
no - Block mirroring is not used
-r remove_delay
Remove delay
This option specifies the delay in minutes for deletion of the files where the
mirrored blocks are stored. This option is only valid when option -m is set to yes.
Signed Integer 1 10080. The default value is 1440.
-v usergroup

16/11/2017 R1
User group name

to modify the transfer queue parameters or delete the transfer queue.
2.1.1 Operands
transferqueue
Transfer queue name
destinationset
Handling (CDH). Identifier 1 - 32 characters
dborm - Direct Block Output, Transfer Queue, Delete
1 Format
dborm transferqueue
2 Parameters
2.1 Operands
transferqueue
Transfer queue name
dsdls - Directory Service Listing
1 Format
dsdls [ -a]
2 Parameters

16/11/2017 R1
2.1 Options
-a If the option is not used, the command will only list your own node. That is the
node that you currently are logged on to.
exalch - External Alarm Receiver Data, Change
1 Format
exalch -s slogan1 -c class -C category [ -o open][ -m clear][ -S slogan2]
[ -t time][ -f file] receiver
exalch [ -o open][ -m clear][ -t time][ -c class][ -C category] -b receiver
-e receiver
2 Parameters
2.1 Options
-C category
Alarm category
This option specifies the alarm category of the alarm. The alarm category
indicates the source of the alarm, for example Power supply equipment (POW).
For the external alarms, there is a direct connection between the alarm category
and the display category as listed below. An alarm display category is part of the
alarm information that is indicated visually and acoustically at an exchange.
If the parameter is omitted, the current value remains.
2 - APZ
7 - APT
8 - POW
15 - EXT
-b receiver
Begin receiver
The first external alarm receiver in the range. For a specification of the receiver
argument, see section Operands.
-c class
Alarm class
This option specifies the alarm class of the alarm. The option argument specifies
the severity of the alarm, where zero (0) is the highest and four (4) the lowest
severity. If the parameter is omitted, the current value remains. Signed integer 0
-4
-e receiver
End receiver
The last external alarm receiver in the range. For a specification of the receiver

16/11/2017 R1
-f file
File name
This option specifies the path and filename of a file where additional information
about the external alarm receiver is stored. If the parameter is omitted, the
current value remains. Text string 1 - 512 characters
-m clear
Manual clear
This option specifies whether the alarm has to be manually cleared or not.
yes - Manual clear of the alarm is required.
no - The alarm does not need to be manually cleared.
-o open
Alarm condition
This option specifies whether the external alarm is to be initiated on open or
closed circuit.
yes - An external alarm will be initiated on open circuit.
no - An external alarm will be initiated on closed circuit.
-s slogan1
Alarm slogan
This option specifies the alarm slogan for the primary cause of the alarm. If there
are spaces in the slogan, quotation marks must surround the slogan. If the
parameter is omitted, the current value remains. Text string 1 - 72 characters
-S slogan2
Additional alarm slogan
This option specifies further details relating to the primary alarm cause, for
example, where the cause of the alarm is located. If there are spaces in the
slogan, quotation marks must surround the slogan. If the parameter is omitted,
the current value remains.
-t time
Filter time for alarm
This option specifies the length of time in seconds between indication in the alarm
circuit and the issuing of the alarm. If the parameter is omitted, the current value
remains. Signed integer 1 - 10
2.1.1 Operands
receiver
External alarm receiver name
This operand specifies the name of the external alarm receiver.
Expressed as exal-m-n where:
m - AP number, Signed integer 1 - 8
n - Receiver individual, Signed integer 0 - 63

16/11/2017 R1
exaldef - External Alarm Receiver Data, Define
1 Format
exaldef -s slogan1 -c class -C category [ -o open][ -m clear][ -S slogan2]
[ -t time][ -f file] receiver
2 Parameters
2.1 Options
-C category
Alarm category
This option specifies the alarm category of the alarm. The alarm category
indicates the source of the alarm, for example Power supply equipment (POW).
For the external alarms, there is a direct connection between the alarm category
and the display category as listed below. An alarm display category is a part of
the alarm information that is indicated visually and acoustically at an exchange.
2 - APZ
7 - APT
8 - POW
15 - EXT
-c class
Alarm class
This option specifies the alarm class of the alarm. The option argument is a signed
integer that specifies the severity of the alarm, where zero (0) is the highest and
four (4) the lowest severity. Signed integer 0 - 4
-f file
File containing additional information for an external alarm receiver
This option specifies the path and filename of a file where additional information
about the external alarm receiver is to be stored. The operator has to check the
authority settings for the file. Text string 1 - 512 characters
-m clear
Manual clear
This option specifies whether the alarm has to be manually cleared or not.
yes - Manual clear of the alarm is required.
no - The alarm does not need to be manually cleared.

16/11/2017 R1
If this option is omitted, the alarm does not need to be manually cleared.
-o open
Alarm condition
This option specifies whether the external alarm is to be initiated on open or
closed circuit. Use one of the following values:
yes - An external alarm will be initiated on open circuit.
no
no - An external alarm will be initiated on closed circuit.
If this option is omitted, the alarm is initiated on a closed circuit.
-s slogan1
Alarm slogan
This option specifies the alarm slogan for the primary cause of the alarm. If there
are spaces in the slogan, quotation marks must surround the slogan.
-S slogan2
Additional alarm slogan
This option specifies further details relating to the primary alarm cause, for
example, where the cause of the alarm is located. If there are spaces in the
slogan, quotation marks must surround the slogan. Text string 1 - 72 characters
-t time
Filter time for alarm
This option specifies the length of time in seconds between indication in the alarm
circuit and the issuing of the alarm. Signed integer 1 10. Default value is 1.
2.1.1 Operands
receiver
exalrm - External Alarm Receiver Data, Delete
1 Format
exalrm receiver
exalrm -b receiver -e receiver
2 Parameters

16/11/2017 R1
2.1 Options
-b receiver
Begin receiver
-e receiver
End receiver
2.1.1 Operands
receiver
exalls - External Alarm Receiver Data, List
1 Format
exalls [receiver]
exalls -l [receiver]
exalls -f
exalls -f receiver
exalls [ -f | -l] -b receiver -e receiver
2 Parameters
2.1 Options
-f File list
This option specifies that the path and filename for the file, with additional
information regarding the external alarm receiver, will be listed.
If a specific external alarm receiver is specified, the path, filename and contents
of the file will be listed. If no external alarm receiver is specified, the paths and

16/11/2017 R1
files, but not the contents of the file, for all defined external alarm receivers will
be listed.
-l Long list
This option specifies that an extended list of attributes for the external alarm
receivers is to be listed.
-b receiver
Begin receiver
-e receiver
End receiver
2.1.1 Operands
receiver
exalblk - External Alarm Receiver, Block
1 Format
exalblk receiver
exalblk -b receiver -e receiver
2 Parameters
2.1 Options
-b receiver
Begin receiver

16/11/2017 R1
-e receiver
End receiver
2.1.1 Operands
receiver
exaldeblk - External Alarm Receiver, Deblock
1 Format
exaldeblk receiver
exaldeblk -b receiver -e receiver
2 Parameters
2.1 Options
-b receiver
Begin receiver
-e receiver
End receiver
2.1.1 Operands
receiver

16/11/2017 R1
exalclear - External Alarm Receiver, Manually Clear
1 Format
exalclear receiver
2 Parameters
2.1 Operands
receiver
ftpcreate - Ftp Create
1 Format
ftpcreate -n sitename -d physicalpath -i IP_address -p port
2 Parameters
2.1 Options

16/11/2017 R1
-n sitename
This option specifies the name of the FTP site to be created. Note that sitenames
which contain space characters must be surrounded by double quotes.
1 - 260 alphanumeric characters
-d physicalpath ...
This option specifies the name of the physical directory on the harddisk to which
the FTP site will be mapped. Make sure that a suitable disk partition (drive letter)
is used. Note that sitenames which contain space characters must be surrounded
by double quotes. 1 - 260 alphanumeric characters
-i IP_address
This option specifies the IP address to which the FTP site will be mapped.
Use dotted decimal notation (numbers separated by dots). The only exception to
dotted decimal notation is when specifying the text string "All Unassigned" which
means that all unassigned IP addresses shall be used by the FTP site. "All
Unassigned" must be used with care, because the FTP server will stop an FTP site
immediately after ftpcreate created it if another FTP site exists which uses the
same port number. ftpcreate will not report this, but any bad IP address or other
misconfiguration, which means that the FTP Site could not be bound to the given
IP address and port, will be reported by the MSFTPSVC service in the system
event log. Generally, care should be taken to only use IP addresses and port
numbers that are known to be correct, to avoid potential problems with the FTP
server when it tries to bind the FTP site to an address. A misconfigured FTP site
should be removed with ftprm and can then be created again with a valid address.
-p port ...
This option specifies the protocol port number to which the FTP site will receive
the requests. 1 - 5 digits
ftpls - Ftp List
1 Format
ftpls
2 Parameters
-
ftprm - Ftp Remove


16/11/2017 R1
1 Format
ftprm -n sitename
2 Parameters
2.1 Options
-n sitename ...
This option specifies the name of the FTP site which is to be removed. Note that
sitenames containing space characters must be surrounded by double quotes.
fchcommit - Function Change Commit
1 Format
fchcommit [ -f ]
2 Parameters
2.1 Options
-f Force commit
fchend - Function Change End
1 Format
fchend [ -f]
2 Parameters

16/11/2017 R1
2.1 Options
-f Force end
fchdump -Function Change, Dump
1 Format
fchdump -l dumpFile
fchdump -m dumpFileOut -k dumpFileIn ...
fchdump -e dumpFileOut -k dumpFileIn [ -o file] -g appl ...
fchdump -c dumpFile [ -o file] -g appl ... [ -z cxc ...][ -u cxc ...]
[ -i cxc ...]
fchdump -a dumpFile [ -o file] -g appl ... [ -z cxc ...][ -u cxc ...]
[ -i cxc ...]
fchdump -s dumpFile [ -o file] -g appl ... [ -z cxc ...][ -u cxc ...]
[ -i cxc ...]
2 Parameters
2.1 Options
-a dumpFile
append to dump
This option specifies that following edit options (-g -z -u -i -o) means addition to
specified dump.
-c dumpFile
create dump
This option specifies creation of a dumpfile. Used together with edit options (-g -z
-u -i -o).
-e dumpFileOut
extract a dump
This option is used together with the -k option to extract a new dump from
another dump. The extraction is controlled by the options -g and -o.
-g appl
group
This option specifies a group name or an application name. It makes it possible to
group packages into named groups. The name is case-sensitive.

16/11/2017 R1
-i cxc
instance
This option defines a resource instance file for the specified CXC.
-k dumpFileIn
Input dump-file
This option is used together with the -m or -e options. It points out the input
dumps when merging dumps or extracting a dump.
-l dumpFile
list dump
This option is used to list the contents of the dumpFile. Cannot be used together
with any other option.
-m dumpFileOut
merge dumps
This option is used together with the -k option to merge several dumps into one
dump.
-o file
options
This option allows the user to specify the command-line options for the edit-
commands in a text-file. The file may contain any number of lines. One option per
line. For readability it is also possible to add empty lines and comment lines. A
comment line is a line starting with an #-mark.
-s dumpFile
subtract from a dump
This option specifies that following edit options (-g -z -u -i -o) means subtraction
from specified dump.
-u cxc
uninstall
This option specifies a CXC-package to be uninstalled.
-z cxc
Winzip self-extracting file
This option defines a CXC-package to install.
fchfb - Function Change, Fallback
1 Format
fchfb [ -f]
fchfb [ -u]
2 Parameters
2.1 Options

16/11/2017 R1
-f Force fallback
This option causes the command to run without prompting the operator, that is,
silent.
-u Unconditional fallback
This option will force a fallback even if there is an LBB upgrade which cannot be
reverted.
fchrst - Function Change, Restore
1 Format
fchrst [ -f ]
2 Parameters
2.1 Options
-f Force restore
fchstart - Function Change, Start
1 Format
fchstart [ -o][ -b][ -f][ -h min][ -L][ -c cmd][ -k file][ -u pkg][ -r]
[ -d dir][ -z pkg][ -m file][ -n appl][ -a appl][ -l file]
[ -i file][ -p file][ -x cmd]
fchstart -t
2 Parameters
2.1 Options
-a appl
accept application

16/11/2017 R1
This option can be used together with the -m option and allows the user to specify
an application or group that shall be installed. The name is case-sensitive. This
option can be repeated but cannot be used together with the -n option.
-b bring online
Used to force existing resources online.
-c cmd
command
This option can be used to specify any command that shall be executed before
package installation. The option can be repeated.
-d dir
directory
This option allows the user to specify a staging directory from where new software
packages to be installed will be fetched. The software packages in the staging
directory must be compressed in WinZip self-extraction format, and must be an
Ericsson CXC package, that is, named as 19089*.exe, where * is the CXC
number.
-f force
This option is used to avoid dialogue mode. FCH assumes default answers to
questions.
-h min
Automatic commit and end.
This option allows the user to specify automatic commit and end of a function
change session after a specified supervision period. The option cannot be used
together with options -L, -c and -x.
-i file
instance definition
This option allows the user to add and remove resource instances, such as output
handlers. The argument file is a file containing a list of the paths and names of
the instance files to replace the existing instance files coupled with the paths and
names of the instance files to be replaced.
-k file
installation description file
This option allows the user to specify an installation description file that controls
the installation procedure. The file may contain any other command-line option
except for -k and -t. The -k option may be repeated.
-l file
lbb-file
This options allows the user to replace LBB files on the system with new files. The
argument file is a file containing a list of the paths and names of the files to be
replaced coupled with the names of the files to replace them.
-L LBB installation
This option allows the user to upgrade LBB and 3pp software. An upgrade
instruction must be available. Cannot be used together with option -h.
-m file
dump
This option allows the user to specify a dump-file to be loaded. The file is created
by means of the command fchdump(1m).
The options -a or -n may be used to control which part of the dump to install.
-n appl ...
not accepted application

16/11/2017 R1
This option can be used together with the -m option and allows the user to specify
an application or group that shall not be installed. The name is case-sensitive.
This option can be repeated but cannot be used together with the -a option.
-o [resource]
optional online
This option is used to change the online/offline status for some resources.
-p file
parameter
This option allows the user to copy in pre-edited CXC parameter files. The
argument file is a file containing a list of parameter files to be copied in to the
system.
-r remove
This option allows the user to delete software packages on the system.
-t terminate
This option cannot be used together with any other option. It is used in
emergency when the user wants to abort an ongoing function change session. The
option cannot be used in an installation description file. ( -k option).
-u pkg
uninstall
This option allows the user to specify packages to be uninstalled. The option may
be repeated.
-x cmd
exit command
This option can be used to specify any command that shall be executed after
package installation. The option can be repeated.
-z pkg ...
winzip self-extracting file
This option is used to specify which CXC-packages to install. Must be used
together with -d option. May be repeated.
2.2. Operands
device
device
The device argument causes coping of a package from device to the inactive pair
of system disks of the local system. device can be a full path name to a directory
or to the identifiers for hard disk or tape drive devices (for example, /var/tmp,
dev/dsk/c0t0d0p0s0 , or /dev/rmt/c0s0). It can also be the device aliases.
fchstate - Function Change, State
1 Format
fchstate [ -s][ -i interval][ -r times]

16/11/2017 R1
2 Parameters
2.1 Options
-s Short
Only FCH-state and node status is reported. The explanation is suppressed.
-i interval
Interval in seconds
This options is used together with the -r option. Defines the repetition interval in
seconds.
-r times
Repeat times
This option defines that the command is repeated a number of times. Used
together with the -i option.
IntegrityAP - Integrity Verification
1 Format
IntegrityAP [ -b <(path)filename>] [ -c] [ -n] [ -t]
2 Parameters
2.1 Options
-b <(path)filename>
Baseline file
This option is used to specify the checksum data file to verify against or to create.
-c Create
This option is used to create or recreate the checksum data file.
-n Normal
This option is used to run with normal instead of low priority.
-t Time
This option is used to print the execution time.

16/11/2017 R1
cpdchange - IO Device in CP, Attributes, Change
1 Format
cpdchange -d dest device
cpdchange [ -e eol][ -n eop][ - r time][ -s no|yes][ -v prca][ -y lines]
[ - z none|ff] device
2 Parameters
2.1 Options
-d dest
Destination device
This option moves the printout queue to the given destination IO device.
Expressed as AD-n where:
n - Signed integer 0 - 1023
-e eol
End of line marker
This option specifies the combination of characters that will separate each row in
the printout. If the parameter is omitted, the current value remains.
-n eop
End of printout marker
This option specifies the combination of characters that will separate each
printout. If the parameter is omitted, the current value remains.
-r time
Rerouting time
This parameter specifies the time in minutes that elapses before routing to a
standby device takes place when the destination is not obtainable.
If rerouting is to take place immediately when the destination is not obtainable,
specify zero (0). If rerouting is not desired, specify minus one (-1).
If the parameter is omitted, the current value remains. Signed integer -1 - 1440
-s no|yes

16/11/2017 R1
Separated CP-SB side

This option specifies if the Input/Output (IO) device is to handle printouts from
the separated Central Processor (CP)-Standby (SB) side.
no - Printouts from the CP-EX side are handled.
yes - Printouts from the separated CP-SB side are handled.
-v prca
Printout category
This option can be used to subscribe to printouts according to their Printout
Category (PRCA) value.
The printout category is expressed as a series of numbers separated with comma
signs (,). A range can be specified by using double full stops (..), or with a single
dash (-). If the parameter is omitted, the current value remains. If prca is set to
-1 the printout subscription is removed. Signed integer -1 - 255
-y lines
Lines per page
This option specifies the number of lines per page. Each page starts with an
exchange header. If the option is omitted, the current value remains. If lines is
set to zero (0) the page is continuous and the page separator, option -z, is set to
none. Signed integer 0, 10 - 1000
-z none|ff
Page separator
This option specifies the page separator.
If the parameter is omitted, the current value remains. Use one of the following
values:
none - No page separator is used.
ff - A form feed character (Hex value H'0C) is inserted as page separator.
If lines per page (option -y) is undefined, lines per page is set to 66
2.1.1 Operands
device
IO device
This operand specifies the name of the IO device.
n - Signed integer 0 - 1023
cpdlist - IO Device in CP, Attributes, List
1 Format

16/11/2017 R1
cpdlist [ -a -l - p -t type]
2 Parameters
2.1 Options
-a Active devices
This option specifies that the attributes of active Man-Machine Language (MML)
sessions and defined Printout Destination Services (PDS) are to be listed.
-l Long list
This option specifies that an extended list of attributes is to be listed.
-p Configuration parameters
This option specifies that configuration parameters for the defined PDS programs
are to be listed. The list includes the default log and program directories, as well
as the installed PDS programs.
-t type
PDS program
This option specifies a PDS program for which usage information is to be printed.
cpdinsert - IO Device in CP, Insert
1 Format
cpdinsert -c cmd [ -r time][ - s][ -v prca][ -y lines][ -z none|ff] device
cpdinsert -f file [ -r time][ - s][ -v prca][ -y lines][ -z none|ff] device
cpdinsert -i ip [ -b ][ -e eol][ - n eop][ -r time][ -s][ -v prca]
[ -y lines][ -z none|ff] device
cpdinsert -q port [ -b ][ -e eol][ - m ipmask][ -n eop][ -r time][ -s]
[ -v prca ][ - y lines][ -z none|ff] device
cpdinsert -x time [ -r time][ - s][ -v prca][ -y lines][ -z none|ff] device
cpdinsert -t type [ -e eol][ - n eop][ -p params][ -r time][ -s][ -v prca ]
[ - y lines][ -z none|ff] device
cpdinsert device
2 Parameters
2.1 Options
-b Printout type information

By using this option, each printout is preceded by an extra line that contains
additional information. This option is to be used only in conjunction with remote

16/11/2017 R1
post-processing systems that have been prepared to take care of this additional
information. Format of the printout type information for alarm printouts:
:type=<type>, cpcide=<cpside>, device=<device>, prca=<prca>,
prseqno=<prseqno>, altype=<altype>, alcls=<alcls>, alcat=<alcat>,
alseqno=<alseqno>, alno=<alno>, alvisno=<alvisno>;
Format of the printout type information for other spontaneous printouts than
alarm printouts:
:type=<type>, cpcide=<cpside>, device=<device>, prca=<prca>;
Format of the printout type information for result and restart printouts:
:type=<type>, cpcide=<cpside>, device=<device>;
type - Type of printout, Possible values: result, restart, spontan , alarm
cpside - CP side , Possible values: ex, sb
device - Device identity where the printout was generated.
prca - Printout category
prseqno - Printout sequence number
altype - Alarm type , Possible values: new, clr, inc, dec, rep
alcls - Alarm class, Possible values: 0 - 4
alcat - Alarm category, Possible values: 0 - 15
alseqno - Alarm event sequence number
alno - Internal unique alarm number
alvisno - Alarm number shown in alarm
-c cmd
Command or script to execute
This option specifies the command or script file that is to be executed whenever a
printout is received. Text string 1 - 255 characters
-e eol
End of line marker
This option specifies the combination of characters that will separate each row in
the printout. If omitted, the default value crlf will separate each row.
lf - Line feed (Hexadecimal value H'0A).
cr - Carriage return (H'0D).
crlf - Carriage return and line feed (H'0D H'0A).
lfcr - Line feed and carriage return (H'0A H'0D).
none - No character separates the rows.
The default value is crlf.
-f file
Output file
This option specifies either the file or directory or both where received printouts
are to be saved. Values can be a file name, a directory name, or a complete path
with directory and file name. A single full stop (.) is used to indicate the default
log file located in the default log directory. If no directory is given, the default log
directory is used. Text string 1 - 255 characters
-i ip
Remote Internet Protocol (IP) address
This option specifies the IP address and port number of the remote server to
which the PDS IP client shall connect and where received printouts are sent. The

16/11/2017 R1
IP address is expressed as a symbolic name or as a 32-bit address written in

dotted-decimal notation, one for each byte of the address. Expressed as
a.b.c.d:port[:time]
-m ipmask
IP address mask
This option is used to restrict the access to the PDS IP server. The given IP address
mask is checked against the IP address of the connecting remote client. If an
unauthorized client tries to connect, the connection is rejected and an event report is
sent stating the IP address of the client.
The characters (*) and (?) have special meaning. The asterisk (*) matches any
sequence of characters, while the question mark (?) matches any single character.
An IP address mask of 134.138.16?.* would match any IP address that begins
with 134.138.16x.n, where x is between 0 and 9, and n is between 0 and 255.
The default IP address mask is *.*.*.*, which means full access from all remote
IP addresses. Symbolic IP address names cannot be given. The IP address mask is
expressed as a.b.c.d
Each of these parts may be replaced part or whole, by the characters * or ?, to
indicate a range of IP addresses.
-n eop
End of printout marker
This option specifies the combination of characters that will be used to mark the
end of the printout. If omitted, each printout is ended with the default value EOT
(H'04). Use one of the following values:
none - No printout separator is used
<hexvalue> - A maximum number of three values in hexadecimal format, each
consisting of two hexadecimal digits.
These characters will then be used to separate the printouts. The default EOT
separator is equal to using -n 04.
-p params
PDS program parameters
This option specifies the parameters used by the custom PDS program specified in
option -t. Use command cpdlist(1M) to get a short description of the parameters
for the custom PDS program. If the parameters consists of space characters it
must be surrounded by quotation marks (").
-q port
Local IP port
This option specifies that the PDS IP server is to establish a listening point where
remote clients can establish a connection to, to retrieve any stored printouts.
When a remote client connects to this port, all stored printouts will be transferred
to the client. The connection is then kept opened until the client disconnects.
Printouts that are received when a client is connected, is transmitted directly to
the client. Signed integer 1 - 65535
Avoid port numbers in range 1 - 1023, since these are reserved for standard
Internet functions.
-r time
Re-routing time
This parameter specifies the time in minutes that elapses before routing to a
standby device takes place when the destination is or becomes faulty.

16/11/2017 R1
If re-routing is to take place immediately when the destination is or becomes

faulty, specify zero (0). If re-routing is not desired, specify minus one (-1).
The printout is discarded if the printout does not allow re-routing, or if no standby
or system standby device is defined. Signed integer -1 - 1440
The default value is zero (0), that is, immediate re-routing when the destination
becomes faulty.
-s Separated CP side
This option specifies that the PDS program is to receive printouts from the
separated Central Processor (CP)-Standby (SB) side.
-t type
PDS program type
This option specifies a custom PDS program that is to be associated with the
Input/Output (IO) device. Use command cpdlist(1M) to list all available PDS
programs. Also use command cpdlist(1M) to see a short description of how to use
the custom PDS program.
-x time
Time for subfile switch
This option specifies when the PDS should continue with a new log file. This option
can be used to split a log file into smaller more manageable subfiles.
The argument time is expressed as an absolute time
[day[,...]:]hour[,...]:minute[,...], where:
day - Day of month, Digit string 01 - 31
or
day - Day of the week, Use one or more values from the following list:
Mon - Monday
Tue - Tuesday
Wed - Wednesday
Thu - Thursday
Fri - Friday
Sat - Saturday
Sun - Sunday
hour Hour, Digit string 00 - 23
minute - Minute, Digit string 00 - 59
Each of these patterns may be either an asterisk (*) (meaning all legal values) or
a list of values separated by commas ( ,). Note that the specification of days may
be made by two fields (day of the month and day of the week). Both are adhered
to if specified as a list of values.
-y lines
Lines per page
This option specifies the number of lines per page. Each page starts with an
exchange header. If this option is omitted the page is continuous. Signed integer
10 - 1000
-z none|ff
Page separator

16/11/2017 R1
This option specifies the page separator.

This option is only valid in combination with option -y. Use one of the following
values:
none - No page separator is used.
ff - A form feed character (H'0C) is inserted as page separator.
Default value is none.
-v prca
Printout Category
This option can be used to subscribe to printouts according to Printout Category
(PRCA) values.
Typical PRCA values are:
35 Processor supervision (heartbeat)
36 Periodic alarm list printout
37 - 46 Alarm categories 0 - 9
51 - 56 Alarm categories 10 - 15
Expressed as a series of numbers separated by comma signs (,). A range can be
specified by using double full stops (..) or with a single dash (-).
2.1.1 Operands
device
IO device
This operand specifies the name of the IO device witch is to be associated with
the PDS program.
n - Device number, Signed integer 0 - 1023
Note: Due to backward compatible reason, AD-1 and AD-2 cannot be used.
cpdremove - IO Device in CP, Remove
1 Format
cpdremove device ...
2 Parameters
2.1 Operands
device

16/11/2017 R1
IO device
This operand specifies the name of the Input/Output (IO) device.
n - Device number, Signed Integer 0 - 1023
cpdtest - IO Device in CP, Test
1 Format
cpdtest [ -c -m -p -s]
2 Parameters
2.1 Options
-c Channel list
This option specifies that the attributes of all connected CP-AP channels are to be
listed.
-m Measurement data
This option generates a measurement of how long it takes to send ten (10)
messages between the CP and AP, and then lists the result.
-p Printout list
This option specifies that the attributes for all not yet finished printouts are to be
listed.
-s Show statistics
This option lists some statistics counters.
ipnaadm - IPNA Administration
1 Format

16/11/2017 R1
ipnaadm -state state -ipnano ipnano

ipnaadm -list
ipnaadm -osdump
ipnaadm -osdump -list
ipnaadm -osdump -get <file>
ipnaadm [-help|-h|?]
2 Parameters
2.1 Operands
-state state -ipnano ipnano

Change ipna state
This operand allows the state of a connected ipna to be changed to normal or
separated.
where state = nor(mal) or sep(erated) and ipnano is in the range 0-63.
-list List connected ipnas
This option lists the ipnas connected to an APG40.
-osdump
IPNA OSE dump commands
Open an explorer window in the ose dump directory.
-osdump -list
List available ose dump files
-osdump -get file
Get an ose dump file
Where file = name of ose dump file (see osdump -list)
-help Print usage
Also -h, or ?
ispprint - ISP Print Tool
1 Format
ispprint [ -a][ -g][ -t starttime][ -x endtime ]
2 Parameters
2.1 Options
-a Analysis flag

16/11/2017 R1
This option indicates that an analysis of the log should be done before the
printout. If this flag is not given, a printout of the log, without analysis will be
performed.
-g GMT flag
This option indicates that the log should be printed according to Greenwich mean
time. If the flag is not given, local time will be used.
-t starttime
Start time
This option indicates the beginning of the interval that will be presented.
Expressed as YYMMDD-HHMM:
YY - Year, Must be greater than 00. If year is less than 70 it indicates 20YY and if
year is greater or equal with 70 it indicates 19YY.
MM - Month, Must be greater than 00.
DD - Day, 01 will be used if day is not given.
HH - Hour, 00 is used if hour is not given.
MM - Minutes, 00 is used if hour is not given.
If this parameter is not given, the start time of the log will be used.
-x endtime
End time
This option indicates the end of the interval that will be presented.
Expressed as YYMMDD-HHMM:
YY - Year, Must be greater than 00. If year is less than 70 it indicates 20YY and if
year is greater or eaqual with 70 it indicates 19YY.
MM - Month, Must be greater than 00.
DD - Day, 01 will be used if day is not given.
HH - Hour, 00 is used if hour is not given.
MM - Minutes, 00 is used if hour is not given.
If this time is not given the current time will be used.
mktr - Make Trouble Report
1 Format
mktr YYMMDD-HHMM [-a][-c][-d][-p]
2 Parameters
2.1 Options
-a AppSight logfiles included (Only APG40)


16/11/2017 R1
AppSight system level black box service will record logfiles and save these in
directories: F:\"hostname"\sessions. With the -a operand three latest AppSight
logfiles (sessions) will be included in the mktr.zip file.
-c Cluster log included (Only APG40)
Windows NT will capture a cluster log and save this in the file:
C:\acs\logs\Cluster.log. With the -c operand the cluster log will be included in the
mktr.zip file.
-d Memory dump included (Only APG40)
Windows NT will capture a physical memory dump and save this in the file:
F:\Memory.dmp. With the -d operand the Memory.dmp will be included in the
mktr.zip file.
-p Pha-parameter printout included (Only APG40)
Command phaprint will print all parameters to file phaprint.txt. With the -p
operand the parameter printout file will be included in the mktr.zip file.
2.1.1 Operands
YYMMDD-HHMM
Start time
This operands has two parts where YYMMDD specifies the date, HHMM specifies
the time.
YY two digits representing the year. A value lower than 70 implies 21st century, a
value higher or equal to 70 implies 20th century.
MM two digits representing the month.
DD two digits representing the day.
HH two digits representing the hour (24-hour clock).
MM two digits representing the minute.
mml - Man-Machine Language, Commands, Execute
1 Format
mml [ -ac][ -s -Q][ -d device][ -i device -I device][ - y lines]
mml [ -s][ -d device][ - i device -I device][ -r time][ -w time] command...
mml [ -bcs][ -l line][ -r time][ -w time] - f file
2 Parameters
2.1 Options

16/11/2017 R1
-a Receive spontaneous printouts

This option specifies that spontaneous printouts, for example alarm printouts, are
received. If the option is not specified, only answer printouts and result printouts
of the Man-Machine Language (MML) commands are received.
-b Break inhibit
This option specifies that the operator wants to continue the execution of an MML
command file, even though that MML command is not successfully executed. If
the option is not specified, the execution of the MML command file stops in event
of an error.
-c Confirm automatically
This option specifies automatic confirmation of the command. This option is
included as default when an MML command is specified as an operand. If MML
commands are executed from a file and output is redirected to an output file, this
option must be specified since there is no way to confirm the commands
manually.
-d device
Requested Input/Output (IO) device
This option specifies the IO device to be used. Expressed as AD-n where:
-f file
MML command file
This option specifies that MML commands contained in a text file are executed.
Text string
-i device
Copy printouts
This option specifies that result printouts of the MML commands and spontaneous
printouts are copied to the specified IO device. Answer, procedure and check
printouts are not affected. Expressed as AD-n where:
-I device
Redirect printouts
This option specifies that result printouts of the MML commands and spontaneous
printouts are redirected to the specified IO device. Answer, procedure and check
printouts are not affected. Expressed as AD-n where:
-l Start Line
This option specifies the line number, in the MML command file, from where
execution starts. If this option is omitted the execution starts from the first line in
the MML command file. Signed integer 1 - 2 147 483 647
-Q Select Central Processor (CP) side
This option enables the command to be included in the login configuration file.
After a successful logon,the following question appears:
Connect to CP-EX? yes/[no]:
yes, establishes a connection to the Executive (EX) side of the CP.
no, establishes a connection to the separated Standby (SB) side. The default
answer is yes.

16/11/2017 R1
-r time
Retry time
This option specifies the time period an MML command is retried, if the command
returned FUNCTION BUSY. The MML command is sent for execution repeatedly
until the retry time has elapsed or the MML command is accepted. If the option is
not specified, the MML command is not retried. The retry time is specified in
minutes. Signed integer 0 - 1440
-s Connect to separated CP side
This option specifies that the MML command is directed to the separated CP-SB
side. If an MML session is activated, this session is established towards the
separated CP-SB side. If the option is not specified, the MML command is directed
to the CP-EX side.
-w time
Wait time
This option specifies a time limit for waiting for result printouts of the MML
commands. If the wait time is specified to zero (0), the command does not wait
for the result printouts. If the option is not specified, the command waits until the
result printouts are received. The waiting time is specified in minutes. Signed
integer 0 - 1440
-y lines
Lines per page
This option specifies number of lines per page. Each page starts with an exchange
header. If this option is omitted the page is continuous. Signed Integer 10 - 1000
2.1.1 Operands
command...
MML command
This operand is a valid MML command string. The operand is repeatable.
msdls - Message Store Listing
1 Format
msdls -m message_store -s site -d data_file [ -n -t]
msdls -m message_store -s site [ -a]
msdls
msdls -m message_store -s site -S
2 Parameters
2.1 Options

16/11/2017 R1
-a Show all files

With this option, all files in the message_store are listed. Also files containing
already acknowledged messages.
-d data_file
Data file name
This option is the name of the data file to examine. The name can be found by
printing the message_store with the -m and -s options only.
-m message_store
Message store name
This option is the name of the message store.
-n Show only message number
With this option, only the message number of the stored messages is printed.
-s site
Site name
This option is the name of the site allowed to store data in the message_store.
-S Statistical information
With this option, the statistical information is displayed.
-t Truncate data
With this option, truncation of the output is done. Display only the 16 first bytes in
each record.
mtzln - Multiple Time Zone Link
1 Format
mtzln -p
mtzln [ -f] TZ_name TMZ_value
mtzln -r TMZ_value
2 Parameters
2.1 Options
-p List Flag
Only available in APG40. This option lists all defined links in the AP.
-f Force Flag
This option force definition of a link and is used when a link must be redefined.
-r Remove Flag
Only available in APG40. This option removes the defined link, that is connected
to the given TMZ_value.

16/11/2017 R1
2.1.1 Operands
TZ_name
Time Zone name in AP.
This operand specify the time zone name in the AP. In APG40 it must be
surrounded by quotation marks, where it is the Windows NT time zone name. In
APG30 it is the name of the Unix time zone name and is not surrounded by
quotation marks.
TMZ_value
Time Zone number.
This operand specify the CP time zone identifier which the TZ_value will be
connected to.
Integer 0 - 23
hwils - Node Position, List
1 Format
hwils
2 Parameters
-
hwiset - Node Position, Set
1 Format
hwiset [-d] [-r CabRow -s CabNo [-n CabComments] -p UneqPrN -u MagNo
-x MagXPos -y MagYPos [-m MagComments]]
2 Parameters
2.1 Options
-d Dialog Mode
This option initiates the dialog mode of the command

16/11/2017 R1
-r CabRow
Cabinet Row
This option specifies the cabinet row. Integer 1 - 999
-s CabNo
Cabinet Number or section
This option specifies the cabinet number. Integer 1 - 999
-n CabComments
Comments
This option gives the operator the possibility to enter some comments about the
cabinet information. Quoted String 1 - 255 characters (only English)
-p UneqPrN
Unequipped magazine product name
This option specifies the product name of the unequipped magazine. Quoted
String 1 - 31 characters (only English)
-u MagNo
Magazine Number
This option specifies the RP Bus Serial Branch magazine Number. Integer 0 - 255
-x MagXPos
Magazine Horizontal Position
This option specifies the horizontal Position of the magazine in the cabinet. nteger
0 - 255
-y MagYPos
Magazine Vertical Position
This option specifies the vertical position of the magazine in the cabinet. Integer
0 - 255 characters (only English)
-m MagComments
Comments
This option gives the operator the possibility to enter some comments about the
magazine information. Quoted String 1 - 255 characters (only English)
2.2 Dialogue Commands
hwiset -d
Initialize the dialog mode of the command.
The operator is prompted to enter the following information in sequence (Note
that in dialog mode none of the entries can be omitted):
Cabinet Information:
-The cabinet row : An integer between 1-999
-The cabinet number: An integer between 1-999
-Comments to the cabinet information: Yes or No
-If Yes was entered to the latest question, the operator is asked to enter some
comments: A string between 1-255 characters (only English)
Magazine Information:
-The product name of the unequipped magazine: A string between 1-31
characters (only English)
-The RP Bus Serial Branch magazine number: An integer between 0-255
-The magazine horizontal position: An integer between 0-255

16/11/2017 R1
-The magazine vertical position: An integer between 0-255

-Comments to the magazine information: Yes or No
-If Yes was entered to the above question, the operator is asked to enter some
comments: A string between 1-255 characters (only English)
trautil - Operators Interface to the ACS Trace Function
1 Format
trautil [ -l][ -dc]
trautil [ -m memory_size]
trautil [ -o ON_or_OFF]
2 Parameters
2.1 Options
-dc Delimiter character

This option uses character c as delimiter in the display of the trace parameters.
-l Log command input
This option writes command input to standard output.
-m memory_size
Memory size
This option is used to change the trace memory size.
-o ON_or_OFF
ON or OFF.
This option is used to trace on or off.
Create task_name trace_set LOG number_of_buffers

Create a trace task

16/11/2017 R1
This dialogue command creates a trace task that will log a subset of traceable
events in a cyclic trace log, with a specified number of buffers.
Operands
task_name This operand specifies the name of the trace task.
trace_set This operand specifies the subset of events.
number_of_buffers This operand specifies the number of buffers.
LOG This operand is not a variable.
A trace task selects a trace set. A trace set can include a combination of basic
trace sets.
A basic trace set is defined by its type and value. There are four different basic
trace sets:
A specific trace record.
Type: R
Value: Trace record name
All the trace records in a specific group (class, subsystem or other group). This is
implemented as a wild card in the end of the record name, and assumes that the
trace record names follow the Adjunct Processor (AP) name rules.
Type: C
Value: Name of class or subsystem
All the trace records in a specific process.
Type: P
Value: Process name
APG40: The process name is always interpreted as a lower case.
All the records in a specific (active) process instance.
Type: I
Value: Process id (pid)
A trace set can also be defined to include a combination of basic trace sets, using
characters (+, -, *) operators and parenthesis. It is possible to define a trace set
as:
All trace records in set 1 except the trace records in set 2, using the minus (-)
character as operator.
All trace records in set 1 and all trace records in set 2, using the plus (+)
character as operator.
All trace records in set 1 that are also in set 2, using the asterisk (*) character as
operator.
For example:
P my_trace - ( C my_class - C my_class_tr1 )
will select all traceable events in the my_trace process, except the traceable
events in my_class that are not in my_class_tr1. Restriction: if a process
instance is specified in one of the basic sets, only trace records in the process
instance will be selected.
Delete [task_name]
Delete trace task
This dialogue command deletes the specified trace task. If no trace task is
specified, delete all trace tasks. Deletion of another user's task is not permitted.
Flush task_name
Format and flush to standard output

16/11/2017 R1
This dialogue command formats and flushes (displays and removes) to standard
output the contents of the trace log buffers generated by the specific trace task.
List List trace tasks
This dialogue command lists all the trace tasks.
quit Quit
This dialogue command exits trautil and returns the operator to the shell prompt.
Wait time_in_seconds
Sleep time
This dialogue command puts the ACS trace function to sleep for some specified
time, which is specified with the operand time_in_seconds .
X Check and display contents of internal data structures
This dialogue command is used to check and display the contents of the internal
data structures in the shared memory trace container. It is only intended to
provide the diagnostic information needed to analyse the AP behaviour.
phabup - Parameter Handling, Backup
1 Format
phabup file
2 Parameters
2.1 Operands
file ...
File name
This operand specifies the file name for the parameter backup file.
phacreate - Parameter Handling, Create
1 Format
phacreate [ -c -D] [ -a application_name] CXC_name ...
[-a application_name CXC_name...] ...
phacreate [ -c -y] prod_id ...

16/11/2017 R1
2 Parameters
2.1 Options
-a application_name
Subsystem name
This is the name of the subsystem in which the CXC_names can be found. It can
be the Adjunct Processor Subsystem (ACS) or any subsystem according to the
Adjunct Processor (AP) directory structure.
There should NOT be any space between -a and the application_name.
The default for application_name is the ACS subsystem.
-c Check
This option specifies that the parameter files are checked against the format files,
but the parameter tables are not created.
-D Delete
The parameters for the listed CXCs will be deleted from the parameter tables. The
parameter files will not be altered.
-y This option suppresses the check printout. That is, the operator will not be requested to
confirm creation of parameter tables if function change status is not correct.
2.1.1 Operands
CXC_name ...
CXC name
This is the name of the CXC to identify the parameter file and the format file with
the parameters to be loaded. More than one CXC_name can be provided. The
CXC_names are related to the -aapplication_name preceding them.
prod_id ...
Product identity
This operand specifies the product identity expressed as [appl_name/]cxc_no
where:
appl_name is the application name (same as subsystem name).
cxc_no is the load module number.
The product identity identifies the parameter file and the format file with the
parameters to be loaded. The application name is the name of the subsystem in
which the load module number can be found. If the application name is omitted
the ACS subsystem is selected as default. More than one product identity can be
provided.
phaedit - Parameter Handling, Edit


16/11/2017 R1
1 Format
phaedit prod_id
2 Parameters
2.1 Operands
prod_id
Product identity
where appl_name is the application name (same as subsystem name) and cxc_no
is the load module number. The product identity identifies the parameter file and
the format file with the parameters to be loaded. The application name is the
name of the subsystem in which the load module number can be found. If the
application name is omitted the ACS subsystem is selected as default.
edit parameter | named_table

Edit parameter or named table.
This dialogue command initiates a new dialogue where the operator may change
the values for a parameter or a named table. The parameter elements are
displayed one by one at the console. The type, constraints and the current value
are shown for each element. The operator may type a new value or he may keep
the value unchanged by typing the enter key. If the parameter belongs to a
named table the parameter name must be composed of a prefix, the table name
and a suffix. The three parts are separated by dollar ($) signs. If a named table is
specified, all parameters belonging to the named table can be edited. The value
for a particular element must comply to the type and constraints defined in the
format file. See 5.3.2 Printout parameters, type, for a description of parameter
element types and the permitted limits. Integer types may be entered as either
decimal or hexadecimal values. A hexadecimal value must be preceded by '0x'. An
integer type may also be entered as a character surrounded by single quotes (').
String type values must be surrounded by double quotes ("), however if an
identifier is entered the quotes may be omitted.
end Write parameter changes to the parameter file end exit the command.
This dialogue command writes the parameter changes to the parameter file and
exits the command.
insert parameter
Insert parameter in a named table.
This dialogue command initiates a new dialogue where the operator inserts a
parameter in a named table. The parameter name must be composed of a prefix,
the table name and a suffix. The three parts are separated by dollar ($) signs. The
parameter elements are displayed one by one on the console. The type and
constraints are shown for each element. The operator must enter values for each

16/11/2017 R1
parameter element. The value for a particular element must comply to the type
and constraints defined in the format file. See 5.3.2 Printout parameters, type,
for a description of parameter element types and the permitted limits. Integer
types may be entered as either decimal or hexadecimal values. A hexadecimal
value must be preceded by '0x'. An integer type may also be entered as a
character surrounded by single quotes ('). String type values must be surrounded
by double quotes ("), however if an identifier is entered the quotes may be
omitted.
list List parameters
This dialogue command lists all parameters and named tables in the parameter
file.
print parameter | named_table
Print a parameter or a named table.
This dialogue command prints a parameter or a named table to the console. The
parameter elements are printed with types constraints and values. If a named
table is specified, all parameters belonging to the named table are printed.
quit Discard parameter changes and exit the command.
This dialogue command discards the parameter changes and exits the command.
remove parameter
Remove parameter from a named table.
This dialogue command removes a parameter from a named table. The parameter
name must be composed of a prefix, the table name and a suffix.
write
Write parameter changes to the parameter file.
This dialogue command writes the parameter changes to the parameter file.
phaprint - Parameter Handling, Print
1 Format
phaprint [ -l level][parameter_name]
phaprint [ -t named_table][parameter_name]
2 Parameters
2.1 Options
-l level
Parameter level
This option specifies the level in the system where the parameter is installed.
private

16/11/2017 R1
Private level - Only parameters at private level are printed.

local
Subsystem level - Only parameters at subsystem level are printed.
system
System level - Only parameters at system level are printed.
-t named_table
Named table
This option specifies the named table containing all the parameters supplied by
the different load modules. The table name and all the parameters in the table are
printed. Patterns may be supplied in order to find a set of Named Tables.
Following patterns are allowed:
'*' Matches any string, including the null string.
'?' Matches any single character.
'[...]' Matches any one of the enclosed characters. A pair of characters separated
by '-' matches any character lexically between the pair, inclusive. If the first
character following the opening '[' is a '!', any character not enclosed is matched.
The default for named_table is all parameters. If a level is specified, all
parameters for that level are chosen, or if a named table is specified, all
parameters for that named table are chosen.
2.1.1 Operands
parameter_name
Parameter name
This operand specifies the name of the parameter to be printed. Patterns may be
supplied in order to find a set of parameters. For an explanation of patterns, see
the description of named tables.
pharm - Parameter Handling, Remove
1 Format
pharm [ -a application_name ][ - v revision] CXC_name
pharm [ -y] prod_id
2 Parameters
2.1 Options
-a application_name
Application name

16/11/2017 R1
APG30:
-v revision
Revision
APG30:
-y This option suppresses the check printout. That is, the operator will not be
requested to confirm removal of parameter tables.
2.1.1 Operands
CXC_name
CXC name
APG30:
prod_id ...
Product identity
where:
appl_name is the application name (same as subsystem name).
cxc_no is the load module number.
The product identity identifies the parameter tables to be deleted. The application
name is the name of the subsystem in which the load module number can be
found. If the application name is ommitted the ACS subsystem is selected as
default.
pharst - Parameter Handling, Restore
1 Format
pharst [ -y] file
2 Parameters
2.1 Options
-y This option suppresses the check printout. That is, the operator will not be asked
to confirm overwriting of the parameter database.
2.1.1 Operands
file ...
File name
This operand specifies the file name for the parameter backup file.

16/11/2017 R1
phatrans - Parameter Handling, Transfer
1 Format
phatrans source_directory target_directory
phatrans source_cxc [target_cxc]
2 Parameters
2.1 Operands
source_directory
Source directory
APG30
target_directory
Target directory
APG30
source_cxc
Source load module number
This operand specifies the load module number of the source product package.
The source product package must be stored in the directory
<AP_DATA>\FCH\current\<source_cxc> .
This is normally done at function change.
target_cxc
Target load module number
This operand specifies the load module number of the target product package.
The target product package must be stored in the directory
<AP_DATA>\FCH\new\<target_cxc> .
This is normally done when installing the package.
If the parameter is omitted the source load module number is used.
prcconf - Process Control, Cluster Configuration
1 Format
prcconf [ -c -d] filename

16/11/2017 R1
2 Parameters
2.1 Options
-c Check syntax
This option checks the syntax in the service start schedule file.
-d Delete cluster configuration
This option deletes the resources and resource groups specified in the service
start schedule file.
2.1.1 Operands
filename
Filename
This operand specifies name of the service start schedule file. The file must be
located in %AP_HOME%\ACS\sys.
prcgen - Process Control, Configuration File, Generate
1 Format
prcgen [ -g resourcegroup -r resource -i instance ]
2 Parameters
2.1 Options
-g resourcegroup
Resource group file.
This option specifies a file that contains resource group parameters for one or
more resource groups.
-r resource
Resource file.
This option specifies a file that contains resource parameters for one or more
resources.
-i instance
Instance file.
This option specifies a file that contains instance parameters for one or more
instances of a resource.

16/11/2017 R1
prcstate - Process Control, Determine State
1 Format
prcstate
2 Parameters
-
rtrch - Record Transfer, Change
1 Format
rtrch [ -a blocklength ][ -d blocklengthtype ][ -e blockholdtime ]
[ -g blockpaddingchar ][ -k generationtime ][ -l resetflag ][ -f]
messagestore site
rtrch [ -h filesize ][ -j fileholdtime ][ -k generationtime ]
[ -l resetflag ][ -m fixedfilerecords][ -n filerecordlength]
[ -o filepaddingchar][ -f] messagestore site
rtrch [ -a blocklength ][ -d blocklengthtype ][ -e blockholdtime ]
[ -g blockpaddingchar ][ -h filesize ][ -j fileholdtime ]
[ -k generationtime ][ -l resetflag ][ -m fixedfilerecords]
[ -n filerecordlength][ -o filepaddingchar] action
2 Parameters
2.1 Options
-a blocklength
Maximum Block Length
This option specifies the maximum length of a Call Record Block (CRB) expressed
in bytes. Signed integer 512 - 32768
-d blocklengthtype

16/11/2017 R1
Type of block length

This option specifies in whether the block length is fixed, variable or variable with
even number of bytes. Use one of the following values:
FIXED
Length of a CRB is fixed. This value should be used when CRBs must have a fixed
length. Bytes not occupied by a call record are filled with the character specified
by blockpaddingchar.
VARIABLE
Length of a CRB is variable. This value should be used when a fixed CRB length is
not required. The length of a CRB will be adjusted so that no unused bytes will be
included.
EVEN
Length of a CRB is variable, but must be an even number of bytes. This value
should be used when a fixed CRB length is not required, but an even number of
bytes. The length of a CRB will be made even, and if necessary by addition of the
padding character specified by blockpaddingchar.
-e blockholdtime
Block holding time
This option specifies the maximum number of seconds a CRB is held before sent,
expressed in seconds. Signed integer 1 - 7200
-f Forced flag
This option is used for omitting of comfirmation prompter. To be used in scripts.
-g blockpaddingchar
Block padding character
This option specifies the decimal value of a character that is used to fill the
unused bytes in a fixed length CRB or in a CRB with a variable length but with a
required even number of bytes. Signed integer 0 - 255
-h filesize
Maximum size for a file
This option specifies the maximum size of a CRB file expressed in kilobytes.
-j fileholdtime
File hold time
This option specifies the maximum time a file is held before sent and a new CRB
file is created. Time expressed in seconds. Signed integer 1 - 86400
-k generationtime
Statistic Generation Time
This option specifies which time of the day when a statisctics output is generated.
Time is given in the form <hh:mm>. Identifier 5 - 5 characters
-l resetflag
Statistics Reset flag
This option specifies whether the statistics counters are reset after generation of
statistics output. Use one of the following values:
YES - Statistics counters are reset.
NO - Statistics counters are not reset.
-m fixedfilerecords
Fixed file record length flag

16/11/2017 R1
This option specifies that the components of a file (records) will have a fixed
length. The tail of a record will be padded if necessary. Use one of the following
values:
YES - File records will be padded to a fixed length.
NO - Variable file record length, no padding.
-n filerecordlength
Fixed record length
This option specifies the fixed length of a file record expressed in bytes. Signed
integer 512 - 32768
-o filepaddingchar
File padding character
This option specifies the decimal value of a character that is used to fill the
unused bytes in a fixed file record. Signed integer 0 - 255
2.1.1 Operands
action
Kind of action
This operand specifies action.
Use this (currently the only) value:
SET DEFAULT - Default values record is updated.
messagestore
Message store name
This operand specifies the name of the message store to retrieve data from. The
operand is not case sensitive. The operand must begin with a letter. Identifier
1 - 15 characters
site Site name
This operand specifies the name of the site from where the message store
receives data. The operand is not case sensitive. The operand must begin with a
letter. Identifier 1 - 15 characters
rtrdef - Record Transfer, Define
1 Format
rtrdef -a dfile_queue messagestore site
rtrdef -b block_queue messagestore site

16/11/2017 R1
2 Parameters
2.1 Options
-a file_queue
File transfer queue
This option specifies the transfer queue name as defined in AP File Processing
(AFP). Identifier 1 - 32 characters
-b block_queue
Block transfer queue
This option specifies the transfer queue name as defined in Direct Block Output
(DBO). Identifier 1 - 32 characters
2.1.1 Operands
messagestore
Message store name
1 - 15 characters
site Site name
rtrls - Record Transfer, List
1 Format
rtrls [ -s][messagestore site]
rtrls -d
2 Parameters
2.1 Options
-s Statistics printout
This option specifies that runtime statistics about RTR is printed.
-d Default parameter values
This option lists the default values for all configurable parameters.
2.1.1 Operands

16/11/2017 R1
messagestore
Message store name
1 - 15 characters
site
Site name
rtrrm - Record Transfer, Remove
1 Format
rtrrm [ -f ] messagestore site
2 Parameters
2.1 Options
-f Forced flag
This option is used for omitting of confirmation prompter. To be used in scripts.
2.1.1 Operands
messagestore
Message store name
1 - 15 characters
site Site name

16/11/2017 R1
spchange - Site Parameter Change
1 Format
spchange [ -h]
spchange [ -help]
spchange [ -dis]
spchange [ -display]
spchange [ -lmhosts]
spchange [ -f][ -nr][ -n node_name][ -ip node_ip-address ][ -d domain_name]
[ -s subnet_mask][ -g default_gateway_ ip-address]
[ -cn cluster_name][ -cip cluster_ip-address]
spchange [ -force][ -norestart][ -nodename node_name ]
[ -nodeip node_ip-address][ -domain domain_name]
[ -subnet subnet_mask][ -gateway default_gateway_ip-address]
[ -clusname cluster_name][ -clusip cluster_ip-address]

16/11/2017 R1
2 Parameters
2.1 Options
-h
-help Help
This option displays SPChange help.
-dis
-display
Display
This option displays the current settings.
-f
-force
Force
This option enables no prompting.
-nr
-norestart
No restart
This option prevents the APG40 from restart after SPChange has terminated.
-n node_name
-nodename node_name
Node name
This option allows the user to specify the new node name.
-d domain_name
-domain domain_name
Domain name
This option allows the user to specify the new domain name for the APG40.
-s subnet_mask
-subnet subnet_mask
Subnet
This option allows the user to specify the new subnet mask for the node.
-g default_gateway_ip-address
-gateway default_gateway_ip-address
Gateway
This option allows the user to specify the new default gateway IP-address for the
node.
-ip node_ip-address
-nodeip node_ip-address
Node IP-address
This option allows the user to specify the new IP-address for the node.
-cn cluster_name
-clusname cluster_name
Cluster name
This option allows the user to specify the new cluster name (Only on PDC).
-cip cluster_ip-address
-clusip cluster_ip-address
Cluster IP-address.
This option allows the user to specify the new cluster IP-address (Only on PDC).
-lmhosts
Lmhosts

16/11/2017 R1
This option updates the lmhosts files on both nodes in case the node name has
been changed only on the PDC and not on the BDC.
sfcend - Soft Function Change, End
1 Format
sfcend
2 Parameters
-
sfcexec - Soft Function Change, Execute
1 Format
sfcexec
2 Parameters
-
sfcfb - Soft Function Change, Fallback
1 Format
sfcfb
2 Parameters

16/11/2017 R1
swlist - Software List
1 Format
swlist [ -m] [Application]
2 Parameters
2.1 Options
-m Address of machine to query.

Normally, if option is not specified, the local machine will be used but with this
option it is possible to specify an alternative machine that should carry out the
operation.
2.1.1 Operands
Application
Name of application to search for.
If an application is specified, the command will list on which AP the application is
installed. If not specified, all applications found on all APs will be listed.
SwManage - Software Manage
1 Format
swManage -ah Hostname IP-address
swManage -as Servicename Protocol
swManage -rh Hostname
swManage -rs Servicename Protocol
swManage -s
2 Parameters
2.1 Options

16/11/2017 R1
-ah Hostname IP-address

Add a new host.
This option adds a host to the hosts file. The operand Hostname specifies the
name of AP in the AP system. The IP-address is the operand that specifies the
cluster address on the internal network for that AP.
-as Servicename Protocol
Add a new service port.
This option adds a service port to the services file. The operand Servicename
specifies the name of service. The operand Protocol specifies the name of protocol
used by this service. The first unused port number starting on port 6000 will be
automatically assigned to the specified service. Use one of the following values for
Protocol operand:
udp - User Datagram Protocol
tcp - Transmission Control Protocol
-rh Hostname
Remove host.
This option removes the specified host from the hosts file. The operand Hostname
specifies the name of the AP in a AP system.
-rs Servicename Protocol
Remove a service port
This options removes the specified service port from the services file. Operands
Servicename and Protocol specifies the name of the service and name of the
protocol used by this service.
-s
Copy master file to all nodes.
This option copy the master files i.e. hosts and services file from the first AP to
the all other nodes in an AP system. The command is used if for any reason the
master file has been edited manually. The first AP in an AP system is AP that is
defined as a Single Point of Entry - SPOE AP.
swrsid - Software Records, Change or Retrieve the Name

of AP System
1 Format
swrsid [ -h]
swrsid [ -n newsystem ]
swrsid [ -r]
2 Parameters
2.1 Options

16/11/2017 R1
-h History
This option prints the system history. The list of all system names is printed along
with the change dates.
-n newsystem
Change AP system name
This option appends newsystem to the system description file and it will be
returned after subsequent swrsid(1M) calls. If newsystem contains spaces it must
be quoted.
-r Restore AP system name
This option restore the previous system name. The last system name is removed
from the system description file. The name preceding the last name becomes the
current system name.
swrprint - Software Records, Print
1 Format
swrprint [ -l][ -c category][ package ...]
swrprint [ -p][ -c category][ package ...]
2 Parameters
2.1 Options
-c category
Category
This option retrieves information only for packages belonging to a specific
category. category is for example ACS or 3pp.
-l Long format
Specify long format. Additional parameters are retrieved and printed for each
package.
-p Verbose mode
Specify verbose mode. All parameter names and their values in a package are
printed for each package in raw format.
2.1.1 Operands
package
Package
This operand specifies for which packages information will be printed. If not
specified, the command will print information about all packages.

16/11/2017 R1
swrprod - Software Records, Specify, Change and Retrieve

Third Party Products Identity
Format
swrprod [ -n productname identity revision]
swrprod [ -r productname identity revision]
2 Parameters
2.1 Options
-n New product name

This option specifies the new name for the third party product. The operands
productname identity revision are added to the product description file and it will
be returned after subsequent swrprod(1M) calls. If productname identity revision
contains spaces it must be quoted.
-r Remove product name
This option removes the product name with identity and revision from the product
description file. If productname identity revision contains spaces it must be
quoted.
2.1.1 Operands
productname
Productname
This operand specifies the name of the third party product.
identity
Identity
This operand specifies the identity of the third party product.
revision
Revision
This operand specifies the revision of the third party product.
tzls - Time Zone List
1 Format

16/11/2017 R1
tzls [ -a]
tzls [ -a] -t min
tzls [ -a][ -t min] -d bis
2 Parameters
2.1 Options
-a List Flag
This option list all time zones with additional information offset to GMT and
daylight bias.
-t min
Search flag GMT offset
This option restricts the listed time zones to only show time zones with an offset
of min to GMT, where min is specified in minutes.
Integer 0 - 1380
-d bis
Search flag daylight bias.
This option restricts the listed time zones to only show time zones with an
daylight bias of bis, where bis is specified in minutes.
Integer 0 - 1380
UserDump - User Information
1 Format
UserDump [ -e [file name] ] [ -t]
2 Parameters
2.1 Options
-e excel
This option is used to write comma separated output to a file.
Standard output (stdout) is used if no file is specified.

16/11/2017 R1
-t title
This option is used to write a comma separated title line.
vdcreate - Virtual Directory Create
1 Format
vdcreate -n sitename -a aliasname -d physicalpath
2 Parameters
2.1 Options
-n sitename ...
This option specifies the name of the FTP site on which the virtual directory is to
be created. Identifier 1 - 260 characters
-a aliasname ...
This option specifies the name of the virtual directory. 1 - 260 alphanumeric
characters
-d physicalpath ...
This option specifies the path to the physical directory on the harddisk where the
virtual directory resides. 1 - 260 alphanumeric characters
vdls - Virtual Directory List
1 Format
vdls -n sitename
2 Parameters
2.1 Options
-n sitename ...
The name of the FTP site for which virtual directories are to be listed. Note that
sitenames which contain space characters must be surrounded by double quotes.

16/11/2017 R1
vdrm - Virtual Directory Remove
1 Format
vdrm -n sitename -a aliasname
2 Parameters
2.1 Options
-n sitename
This option specifies the name of the FTP site on which the virtual directory is to
be removed. Note that sitenames containing space characters must be surrounded
by double quotes.
-a aliasname
This option specifies the name of the virtual directory to be removed. Note that
alias names containing space characters must be surrounded by double quotes.
prcboot - Process Control, Reboot
1 Format
prcboot [ -s]
2 Parameters
2.1 Options
-s Shutdown
This option specifies a shut down of the AP (Adjunct Processor) node.

16/11/2017 R1
ntbackup - Backup drives / folders to tape
1 Format & parameters description
NTBACKUP /nopoll
Erase the tape (Requires user confirmation)
NTBACKUP /missingtape
Convert tape to single unit rather than part of a set
(Requires user confirmation)
NTBACKUP EJECT [/tape:{n}]
NTBACKUP BACKUP path [/a] [options] [/t {type}] [/l "logfile"] [/tape:
{n}]
options:
/a Append rather than overwrite backup sets onto the tape
(required if more then one drive is to be backed up)
/b Backup the local registry
/d "text" Description of the backup
/e Include only exceptions in the backup log
/hc:on Hardware compression on
/hc:off Hardware compression off
/l "logfile" The filename for the backup log
path One or more paths to be backed up
/r Restrict access
/tape:{n} The tape drive 'n' is a number from 0 to 9
(assigned during tape drive installation)
/t {type} Backup type, can be one of the following:
normal, copy, incremental
differential, daily
/v Verify the operation
hostname - host name resolution description
1 Format
hostname
2 Parameters

16/11/2017 R1
fchevent - Function Change, Event
1 Format
fchevent [-r<processname>] [-e<specificProblem>] [-o<objectOfReference>]

[-d<problemData>] [-t<problemText>] [-v] -s<perceivedSeverity>
-x<probableCause> -c<objectClassOfReference>
2 Parameters
fcc commands
fcc_reset other [-f] - hard restart of other AP node
fcc_save_to_remove other [-f] [-t<sec>] - ready SCSII bus for node replacement
fcc_integrate other [-f] - bringing SCSII bus back on-line
fcc_watchdog {own|other} {enable|disable} [-t<sec>] [-f] - enable/disable watchdog

process
fcc_am_download own -file:<filename> [-f]
cluster - options for cluster command


16/11/2017 R1
The syntax of this command is:
CLUSTER [cluster-name] /REN[AME]:cluster-name

CLUSTER [cluster-name] /VER[SION]
CLUSTER [cluster-name] /QUORUM[RESOURCE][:resource-name] [/PATH:path]
[/MAXLOGSIZE:max-log-size]
CLUSTER /LIST[:domain-name]
CLUSTER [cluster-name] NODE [node-name] node-command
CLUSTER [cluster-name] GROUP [group-name] group-command
CLUSTER [cluster-name] RES[OURCE] [resource-name] resource-command
CLUSTER [cluster-name] {RESOURCETYPE|RESTYPE} [resourcetype-name]
resourcetype-command
CLUSTER [cluster-name] NET[WORK] [network-name] network-command
CLUSTER [cluster-name] NETINT[ERFACE] [interface-name] interface-command
trainit - Initialize Memory for ACS Trace Function
1 Format
trainit [ -s size]
2 Parameters
2.1 Options
-s size
Memory size
Specify size in Kbytes for allocation of the trace shared memory segment.

16/11/2017 R1
sll - System Log Listing
1 Format
sll [ -t start_time ][ -x stop_time -p][ -e class][ -r processName]
[ -s perceivedSeverity ][ -v][ -o objectClassOfReference]
[ -c objectClassOfReference][ -b probableCause][ -f specificProblem]
2 Parameters
2.1 Options
-b probableCause
Probable cause
This option is a description of the cause of the problem. It contains a slogan
provided by the application as help to identify the problem. probableCause may be
a regular expression.
-c objectClassOfReference
Object class of reference
This option is the name of the reporting object to AXE alarm standard (APZ, APT,
PWR, EXT, EVENT). objectClassOfReference may be a regular expression.
-e Class
Class
This option is the class of the event
soft - Software event class
oper - Operation event class
-f specificProblem
Specific problem
This option is a number that identifies the problem.
-o objectOfReference
Object of reference
This option shows in which instance of the object the fault was detected.
objectOfReference may be a regular expression.
Default: No parameter.
-p Print records in reverse order
This option is the log that is scanned from the beginning of the interval to be
presented towards current time.
When the newest record of the log has been presented the function is restarted,
approximately every sixth second, to present a new record stored since the last
restart. The restarting goes on forever and the program has to be stopped by a
kill command.
-r ProcessName
Process name
This option is the name of the reporting process. ProcessName may be a regular
expression.

16/11/2017 R1
-s perceivedSeverity
Perceived severity
This option is the severity of the reporting object according to AXE alarm (APZ,
APT, PWR, EXT, EVENT). perceivedSeverity may be a regular expression.
-t start_time
Start time
This option is the start time of the interval to be presented, format = YYMMDD-
HHMM.
YY - Year, If YY>=70 the year is assumed to be 19YY, if YY<70 the year is
assumed to be 20YY.
MM - Month
DD - Day, If DD is not given, 01 will be used.
HH - Hour, If not HHMM is given 0000 will be used.
MM - Minutes, If HHMM is not given, 0000 will be used.
If "." is given as parameter the start time is the current time. In combination with
the -p option this eliminates old records.
-v Verbose flag
This option indicates that verbose messages are to be reported at execution of the
program.
-x stop_time
Stop time
This option is the end of the interval that is to be presented, format=YYMMDD-
HHMM
YY - Year, If YY>=70 the year is assumed to be 19YY, if YY<70 the year is
assumed to be 20YY.
MM - Month
DD - Day, If DD is not given, 01 will be used.
HH - Hour, If not HHMM is given 0000 will be used.
MM - Minutes, If HHMM is not given, 0000 will be used.
If "." is given as parameter the end time is the current time.
seccease - AP Security Cease Defined Alarm
1 Format
seccease alarm_id
2 Parameters
2.1 Operands
alarm_id
Alarm identification
This operand specifies the alarm identification received from the alarm list in the
AP.

16/11/2017 R1
secmlmnt - AP Security Monitoring List, Maintain
1 Format
secmlmnt
secmlmnt -u|-d [-f file][-p file]
secmlmnt -a -f file | -p file | -f file -p file
2 Parameters
2.1 Options
-a Add entries
This option is used in combination with option f, option p, or both to add one or
more entries to the monitoring list.
-d Delete entries
This option is used in combination with option f, option p, or both to delete one or
more entries to the monitoring list. If only option d is used, all existing entries will
be deleted.
-u Update entries
This option is used in combination with option f, option p, or both to update one or
more entries to the monitoring list. If only option u is used, all modified entries
will be updated.
-f file
Path to a single file
This option is used to add, remove or update an entry in the monitoring list. The
option must be used together with option a, option d, or option u.
-p file
Path to a file with file list
This option is used to add, remove or update several entries in the monitoring list.
The option must be used together with option a, option d, or option u. Each line in
a file must have only one path with no space characters.
seclogfind - AP Security Find In Log File
1 Format

16/11/2017 R1
seclogfind request_tag
2 Parameters
2.1 Operands
request_tag
Request label
This operand specifies a request identification to seek in the log file.
Allowed formats for the operand request_tag:
Alrm:38_xx:xxxxxxxxxxxxxx or
Event:38_xx:xxxxxxxxxxxxxx or
38_xx:xxxxxxxxxxxxxx or
yyyymmddxxxxxx or
yyyymmdd
seccheck - AP Security Full Check
1 Format
seccheck [-a alarm_mode][-l script_list][-m mail_address][-s screen_mode]
[-r]
2 Parameters
2.1 Options
-a alarm_mode
Generate alarm
This option specifies if alarms are to be generated or not.
To control alarm generation use one of the following values:
0 - No alarm
Disables the alarm generation. Overrides configuration for all defined subscripts.
1 - Generate alarms
Force the alarm generation. Overrides configuration for all defined subscripts.
-l script_list
Execute subscripts

16/11/2017 R1
This option defines which subscripts are to be executed in the command.

The subscripts must be enclosed by apostrophe.
Without this option the subscripts defined in the configuration file
ACS_SEC_configMain are used.
The following scripts may be included in script_list in the form 'script1 opt
arg;script2 opt arg; ...scriptN opt arg':
The subscript file ACS_SEC_3813.ksh monitors system and application files. To
prepare monitoring list use the command secmlmnt with option p or f . Execution
of this script can be modified by editing the configuration file
ACS_SEC_config3813, or by using the following options and arguments:
a Option a in the command seccheck
m Option m in the command seccheck
s Option s in the command seccheck
r Option r in the command seccheck
This subscript also recognize the options i, f, and p. This options should not be
used here since they are intended for use in the command secmlmnt.
The subscript file ACS_SEC_3818.ksh checks permissions on the directories
/var/spool/cron/crontabs and /var/spool/cron/atjobs. All files in these directories
must have the same name as the name of the owner and all files in these
directories must have the permissions set to x00. Execution of this script can be
modified by editing the configuration file ACS_SEC_config3818, or by using the
following options and arguments:
p <paths_to_controlled_directories>
The subscript file ACS_SEC_3820.ksh checks by default that the FTP configuration
is in secure mode. Execution of this script can be modified by editing the
configuration file ACS_SEC_config3820, or by using the following options and
arguments:
c "StringAtTheBeginingOfLine ControlledStringInTheSameLine
StringAtTheBeginingOfLine ControlledStringInTheSameLine ... ..." syntax like
variable CheckString in the file ACS_SEC_config3820
p <path_to_controlled_file>
The subscript file ACS_SEC_3823.ksh checks by default password aging in the
file /etc/default/passwd and default account inactivity time in the file
/etc/default/useradd. Execution of this script can be modified by editing the
arguments:

16/11/2017 R1

c "PATH/file ParmName=Value PATH/file ParmName=Value ... PATH/file
ParmName=Value" syntax like variable ParmValueStr in the file
ACS_SEC_config3823
The subscript file ACS_SEC_3825.ksh checks that the directory /var/adm/sulog
has root as owner and has permissions 600. This script also investigates
/var/adm/sulog for attempts to achieve user root's rights. Execution of this script
can be modified by editing the configuration file ACS_SEC_config3825, or by using
the following options and arguments:
The subscript file ACS_SEC_3827.ksh checks if unwanted commands exist (as
defined in ACS_SEC_config3827) in the file /etc/inetd.conf. Execution of this script
can be modified by editing the configuration file ACS_SEC_config3827, or by using
the following options and arguments:
p <path_to_controlled_directory>
c "stringNr1 stringNr2 stringNr3 ... stringNri ... stringNrn" syntax like variable
CheckString in the file ACS_SEC_config3827
The subscript file ACS_SEC_382830.ksh checks that permissions of the file
/.rhosts is 600. It also checks the file .rhosts does not contain a "+" character by
it self on any row. This check is done for the file .rhosts in the home directory of
all users. Execution of this script can be modified by editing the configuration file
The subscript file ACS_SEC_3829.ksh checks that the file /etc/hosts.equiv does
not contain a "+" character. Execution of this script can be modified by editing the
arguments:
p <path_to_controlled_directory>
The subscript file ACS_SEC_3837.ksh checks that all users home directories are
not writable by group or others, except users defined in ACS_SEC_config3837.
Execution of this script can be modified by editing the configuration file

16/11/2017 R1

The subscript file ACS_SEC_38chid.ksh checks that all users, except users defined
in ACS_SEC_configChid, have unique User Identity. Execution of this script can be
modified by editing the configuration file ACS_SEC_configChid, or by using the
following options and arguments:
The subscript file ACS_SEC_38misc.ksh checks that the last row in the file
~/.profile or in the file ~/.cshrc for every user is
/opt/ACS/CXC137461/0/bin/ACS_SEC_38267.ksh. The script
ACS_SEC_38267.ksh checks that each users PATH begins with "/bin:" or "/bin/:"
or "/usr/bin:" or "/usr/bin/:". ACS_SEC_38misc.ksh also checks that UMASK is 027
as optimum and no worse than 022 for all users except users named in the file
ACS_SEC_configMisc. Execution of this script can be modified by editing the
configuration file ACS_SEC_configMisc, or by using the following options and
arguments:
-m mail_address
Mail generation
This option controls the mail generation to the supplied mail address.
0 - No mail
Disables mail generation. Overrides configuration for all defined subscripts.
addr - Mail address
Defines the mail recipient for alerts. Overrides configuration for all defined
subscripts.
-r Cease alarms
This option ceases alarms generated by subscripts, no security check is made.
If the option l is used, alarms generated by defined subscripts are removed.
-s screen_mode
Display mode
This option controls the displaying of the command execution.
0 - Do not display
Do not show the result of command execution on the screen. Overrides
configuration for all defined subscripts.
1 - Display (default)
This is default value.
This option shows the result of the execution on the screen. Overrides
configuration for all defined subscripts.

16/11/2017 R1
sadfsconf - System Analysis Daemon FileSystem

Configuration
1 Format
sadfsconf -p
sadfsconf -d filesystemName ...
sadfsconf -i filesystemName ...
sadfsconf [ -c ceaseSpan ] -s severity ... -a alarmLimit ... filesystemName
...
2 Parameters
2.1 Options
-a alarmLimit ...
Alarm-limit
This option describes when an alarm will be raised. An alarm with severity
specified by the -s severity option will be raised when the filesystemName is filled
to more than alarmLimit %. alarmLimit must satisfy: ceaseSpan <= alarmLimit
<= 100. The number of -a options must be equal to the number of -s options.
-c ceaseSpan
Cease span
This option describes when the alarm will be ceased.
The alarm will be ceased when the filesystemName is filled to less than or equal
to alarmLimit-ceaseSpan %.
Default value for ceaseSpan is 2.
-d Delete
This option deletes the filesystemName from the database. Thus, the
filesystemName will be supervised using the default values.
-i Ignore
This option ignores the filesystemName, they will not be supervised by the
System Analysis Daemon.
-p Printout
This option prints the limit for every specified filesystem
-s severity ...
Severity
This option specifies the alarm severity. The severity may be written with upper or
lower case characters. Use one of the following: event, A3, A2 or A1 .
A1 - Highest alarm severity
A2 - Alarm severity
A3 - Lowest alarm severity

16/11/2017 R1
event
Warning
2.1.1 Operands
filesystemName ...
File system name
This operand is the name from either Filesystem or Mounted on columns as
displayed by the command df(1M).
sfcsudo - Soft Function Change Set user
1 Format
sfcsudo [argument ...]
2 Parameters
2.1 Operands
argument
argument
The operand is a command, which the fchadm user is not allowed to execute.
hwifetch - Node Position, Fetch
1 Format
hwifetch
2 Parameters

16/11/2017 R1
dform - Direct File Output, File, Delete
1 Format
dform transferqueue
2 Parameters
2.1 Operands
transferqueue
Transfer queue name
cchres - Configuration Change Restore
1 Format
cchres
2 Parameters
-
stmcc - Statistics and Traffic Measurement, Counter

Collection
1 Format
stmcc -i -e
2 Parameters

16/11/2017 R1
2.1 Options
-e End statistics collection

This option ends the regular collection of statistical counter data by STS on AP.
-i Initiate statistics collection
This option initiates the regular collection of statistical counter data by STS on AP.
stmdbrt - Statistics and Traffic Measurement, Database

Retainment Time
1 Format
stmdbrt -p -t time
2 Parameters
2.1 Options
-p Print database retainment time

-t time
Set database retainment time
The time for which information in the database will be retained, specified as a
number of days in the range of 0..364.
stmfo - Statistics and Traffic Measurement, File Output
1 Format
stmfo -c jobnumber
IF DEFAULT OUTPUT IS SET AS Abstract Syntax Notation 1 (ASN.1)
stmfo -i [ -z outputFormat][ -d dirname][ -t gohDestination][ -a]
[ -p period][ -u] -b begintime -s stoptime -o

16/11/2017 R1

[ -p period][ -u] -b begintime -s stoptime objecttype ...
stmfo -i -z outputFormat [ -d dirname][ -t gohDestination][ -f format] -r
stmfo -i -z outputFormat [ -d dirname][ -t gohDestination][ -f format][ -r]
-e [ -u] -b begintime -s stoptime
[ -e][ -a][ -p period][ -u] -b begintime -s stoptime -o
[ -e][ -a][ -p period][ -u] -b begintime -s stoptime object_type ...
IF THE DEFAULT OUTPUT FORMAT IS SET AS LF (Load Files)
[ -p period][ -u] -b begintime -s stoptime -o
[ -p period][ -u] -b begintime -s stoptime objecttype ...
stmfo -i [ -z outputFormat][ -d dirname][ -t gohDestination][ -f format] -r
stmfo -i [ -z outputFormat][ -d dirname][ -t gohDestination][ -f format]
[ -r] -e [ -u] -b begintime -s stoptime
[ -r][ -e][ -a][ -p period][ -u] -b begintime -s stoptime -o
[ -r][ -e][ -a][ -p period][ -u] -b begintime -s stoptime object_type
...
2 Parameters
2.1 Options
-a Generate absolute counter values

This option is applicable to peg counter data only. It indicates that absolute values
should be generated instead of the default delta values.
-b begin time
Set begin time for generation
This option sets the begin of the time interval for which data should be generated.
The begin time must be specified as [[[YYYY]MM]DD]hhmm. The begin time must
be specified if no static data is requested.
-c jobnumber
Cancel Load File (LF) generation
The specified generation job is cancelled. The files generated for this job, except
for the status file, are also deleted.
-d dirname
Set output directory
This option indicates the name of the directory in which the output files are
placed, relative to the STS_DELIVERYDIR directory on the local machine or the
login directory on remote machines. The default is loadfilesYYYYMMDDhhmmss_xx
indicating the time at which the directory is created, appended with a two digit job
number. When naming a Measuring Program (MP), a report or a directory in the
Statistics and Traffic Measurement Subsystem (STS) the user cannot use the
following characters as they are shell specific : | \ / & ^ * < > " : ?

16/11/2017 R1
-e Generate event LF
This option indicates that a LF containing event data is generated.
-f format
Set Database Management System (DBMS) for which format files are to be
generated. It can be Sybase, Oracle, or operator defined. For each LF a DBMS
specific format file is generated.
-i Initiate LF generation
The generation of LFs is initiated.
-o Select all object types
All available object types are selected.
-p period
Set period of summarising
This option indicates the period over which summaries are calculated in minutes.
For example, "-p 60" indicates that the data is summarised for 60 minutes
periods. The period must be a multiple of the Basic Recording Period (BRP).
-r Generate regular data LFs (only available for use with the LF output format).
This option indicates that load files containing regular data are generated.
-s stoptime
Set stop time for generation
This option sets the end of the time interval over which data should be generated.
The stop time must be specified as [[[YYYY]MM]DD]hhmm. The stop time must be
specified if no static data is requested.
-t gohDestination
Set gohDestination
This options indicates the Generic Output Handler (GOH) destination where the
output files are targeted to. Destinations are defined within the GOH
-u Set Universal Time Coordinated (UTC) time zone
This option sets the time zone to UTC. By default the Adjunct Processor (AP) local
time is used.
-z outputFormat
Set the output format for files being outputted.
This option overrides the default output format. The default output format is set in
the parameter file. It is set from the standard output format in the changeable
section of the parameter file. The default output format can be either LF format or
the Abstract Syntax Notification (ASN1) format.
2.1.1 Operands
object_type ...
Object Type
An Object Type that is part of a list of object type names, separated by blank
spaces. This Operand must be entered in uppercase.

16/11/2017 R1
stmfols - Statistics and Traffic Measurement, Output

Requests List
1 Format
stmfols
2 Parameters
-
stmmp - Statistics and Traffic Measurement, Measuring

Program
1 Format
NOTE: If Object Types (OT) with BRP 15 is used in a report the parameter -b
is required.
IF OT WITH THE BASIC RECORDING PERIOD (BRP) 15 MINUTES ARE DEFINED IN A
REPORT AND THE DEFAULT OUTPUT FORMAT IS SET AS ABSTRACT SYNTAX NOTATION
1(ASN.1) THE FOLLOWING OPTIONS APPLY:
stmmp [ -z ASN.1 ][ -n name][ -p period] -b begintime
[ -s stoptime | -c repeats][ -t gohDestination][ -a][ -u] interval
reportID
stmmp -z LF [ -n name][ -p period] -b begintime
[ -s stoptime | -c repeats ][ -t gohDestination][ -f format][ -r]
[ -e] [ -a] [ -u] interval reportID
REPORT AND THE DEFAULT OUTPUT FORMAT IS SET AS LOAD FILES (LF) THE
FOLLOWING OPTIONS APPLY:
stmmp [ -z LF ][ -n name][ -p period] -b begintime
[ -s stoptime | -c repeats ][ -t gohDestination][ -f format][ -r | e]
[ -a][ -u] interval reportID
stmmp [ -z ASN.1][ -n name][ -p period] -b begintime
[ -s stoptime | -c repeats ][ -t gohDestination][ -a][ -u] interval
reportID
REPORT AND THE DEFAULT OUTPUT FORMAT IS SET AS ABSTRACT SYNTAX NOTATION
1(ASN.1) THE FOLLOWING OPTIONS APPLY:
stmmp [ -z ASN.1 ][ -n name][ -p period][ -b begintime]

16/11/2017 R1
[ -s stoptime | -c repeats][ -t gohDestination][ -a][ -u] interval

reportID
stmmp -z LF [ -n name][ -p period][ -b begintime]
[ -s stoptime | -c repeats ][ -t gohDestination][ -f format][ -r]
[ -e][ -a][ -u] interval reportID
REPORT AND THE DEFAULT OUTPUT FORMAT IS SET AS LOAD FILES (LF) THE
FOLLOWING OPTIONS APPLY:
stmmp [ -z LF ][ -n name][ -p period][ -b begintime]
[ -s stoptime | -c repeats ][ -t gohDestination][ -f format][ -r | e]
[ -a][ -u] interval reportID
stmmp [ -z ASN.1][ -n name][ -p period][ -b begintime]
[ -s stoptime | -c repeats ][ -t gohDestination][ -a][ -u] interval
reportID
IF THE DEFAULT OUTPUT FORMAT IS SET AS EITHER LF OR ASN.1 THE FOLLOWING
OPTIONS APPLY :
stmmp -S (programID | ALL)
stmmp -R (programID | ALL)
stmmp -D programID
stmmp -L [ -l][reportID]
2 Parameters
2.1 Options
-a Generate absolute counter values

This option specifies that absolute counter values are generated.
-b begintime
Set begin time of the Measuring Program (MP)
This option sets the begin time of the MP. The begin time must be specified as
[[[YYYY]MM]DD]hhmm. YYYYMMDD are optional. The current time is used by
default if no begin time is specified. The begin time, if not equal to a Basic
Recording Period (BRP) of 5 minutes, is forward aligned to the next BRP. The
begin time can not be set to earlier than current time. The begin time for Object
Types with BRP=15 must coincide with the 15 minutes BRP times. If both BRP 5
and 15 minutes are used in a report the begin time must coincide with the 15
minutes BRP times.
-c repeats
Set the number of repeats of the MP
This option sets the number of repeats. A repeat value of 1 means that 1 load file
request is issued. The repeat value must be greater than 0.
In defining an MP either the repeat or stoptime value is specified. Where no
stoptime or repeat value is specified, the MP will run indefinitely.
-D programID
Delete an MP
The specified MP ID is deleted.
-e Generate event load files (only available for use with the Load File output format).

16/11/2017 R1
This option specifies that event load files are to be generated.

-f format
Set the database type for the format files (only available for use with the Load File
output format). Set Database Management System (DBMS) for which format files
are to be generated, for example, Sybase, Oracle.
-L [programID]
List MP(s) in short format
The specified MP is listed in short format. Where no programID is specified, ALL
MPs are listed in short format.
-L -l [programID]
List MP(s) in long format
The specified MP(s) is displayed in long format. Where no program ID is specified,
ALL MPs are listed in long format
-n name
Set name of MP
This is the name of the MP. The MP name must be unique. When no name is
specified a unique name is given to the MP by the system. When naming an MP, a
report or a directory in the Statistics and Traffic Measurement Subsystem (STS)
the user cannot use the following characters as they are shell specific : | \ / & ^ *
<>":?
-p period
Set period of MP
This is the summarization period. This option indicates the period over which
summaries are calculated in minutes. For example. "-p 60" indicates that data is
summarized for 60 minute periods. The period must be a multiple of 15 minutes.
-R programID | ALL
Resume MP(s)
The specified MP ID is resumed or ALL MPs are resumed.
-r Generate regular data files (only available for use with the Load File output
format). This option specifies that regular data load files are to be generated.
-S programID | ALL
Suspend MP(s)
The specified MP ID is suspended or ALL MPs are suspended.
-s stoptime
Set the stop time of the MP
This option sets the end time of the MP. The stop time must be specified as
YYYYMMDDhhmm. YYYYDDMM is optional. If it is not equal to a BRP then it is
aligned to the last BRP before the stop time.
-t gohDestination
Set the target destination for the MP
The logical name of a remote computer.
-u Set to UTC time zone
This option sets the time zone to the Universal Time Coordinated (UTC). The
Adjunct Processor (AP) local time is used by default.
-z outputFormat
Set the output format for files being outputted.
This option over rides the default output format. The initial default output format
is Load Files. The default output format can be changed during a function change,
it is set from the standard output format in the changeable section of the

16/11/2017 R1
parameter file. The default output format can be either Load Files (LF) format or
the Abstract Syntax Notation (ASN.1) format.
2.1.1 Operands
interval ...
Set the interval value of the MP
This option sets the amount of time over which each load file is generated. The
value is specified in minutes and must be less than 1440 minutes (24 hours).
If only Object Types with Basic Recording Period (BRP) 15 minutes are used in a
report the interval value must be minimum 15 minutes and a multiple of the BRP
15 and of the summarization period.
If only Object Types with BRP 5 minutes are used in a report the interval must be
a multiple of BRP 5 and of the summarization period.
If both BRP 15 and 5 minutes are used in a report the requirement for BRP 15
minutes must be used for the interval.
reportID
The reportID value of the MP
The option sets the ID of the report to be used in the MP.
stmotd - Statistics and Traffic Measurement, Object Type

Configuration
1 Format
stmotd -i -e -q
stmotd -a -n objecttype ...
stmotd -b BRP objecttype ...
stmotd -p PRIORITY objecttype ...
2 Parameters
2.1 Options
-a Activate data collection for given Object Types

-b Set BRP for given Object Types
This option cannot be repeated in a command.
-e Commit Correction Area
-i Initiate Correction Area
-n Deactivate data collection for given Object Types
-p Set collection priority level for given Object Types

16/11/2017 R1
This option cannot be repeated in a command.

-q Discard Correction Area
2.1.1 Operands
objecttype ...
A list of one or more Object Types, separated by white spaces.
BRP Set Basic Recording Period (BRP) in minutes. Numeral 5 or 15.
PRIORITY
Set collection priority level.
String HIGH, MED or LOW. (Note: the strings are not case sensitive)
stmotls - Statistics and Traffic Measurement, Configuration

and Status, List
1 Format
stmotls [ -c][ -l][objecttype ...]
2 Parameters
2.1 Options
-c List configuration changes for given Object Types

The changes are retrieved from the Correction Area. If this option is omitted, the
active configuration is returned.
-l List configuration for given Object Types in long format
If this option is omitted, a list in short format is returned.
2.1.1 Operands
objecttype ...
A list of one or more Object Types, separated by blanks.
stmrp - Statistics and Traffic Measurement, Report
1 Format

16/11/2017 R1
stmrp name object_type [object_type ...]

stmrp -D reportID
stmrp -L [ -l][reportID]
stmrp -C reportID [ -n name]
stmrp -M reportID -n name [[-r] object_type ...]
stmrp -M reportID [ -n name][-r] object_type ...
2 Parameters
2.1 Options
-C reportID [-n name]

Copy a report
This option is used to copy a report. It is optional to specify a new name for the
copied report. In the case where no name is specified, the name of the report
being copied is used. The reportID identifies the report to be copied.
-D reportID
Delete a report
This option is used to delete a report. This reportID specifies the report to be
deleted.
-L [-l] [reportID]
List a report
This option is used to list a report. By default the report is listed in a short format.
The - l option signifies to list the report in long format. The reportID identifies the
report to be listed. In the case of no reportID being specified, ALL reports are
listed.
-M reportID -n name [[-r] object_type...]
Modify a report
This option is used to modify the name of a report. It is optional to modify the
object_types contained in the report. The reportID identifies the report to be
modified. If the -r option is used the listed object_type(s) are to be removed from
the report. If the -r option is not used the listed object_type(s) are added to the
report.
-M reportID [-n name] [-r] object_type...
Modify a report
This option is used to modify a report. It is optional to modify the name of the
report. The reportID identifies the report to be modified. If the -r option is used
the listed object_type(s) are to be removed from the report. If the -r option is not
used the listed object_type(s) are added to the report.
2.1.1 Operands
name ...
Report name

16/11/2017 R1
The name of the report. The report name can be a maximum of 256 characters in
length. In the case where no name is specified a default name is assigned to the
report by the system.
object_type
Object_type list
This option specifies the names of the object_types to be added or modified in the
report. This Operand must be entered in uppercase.
stmttu - Statistics and Traffic Measurement, Translation

Tables Update
1 Format
stmttu
2 Parameters
-
fosarchive - Flexible Formatter, Archive
1 Format
fosarchive -d destination -p directory -s maxfilesize [ -i][ -m]
archivecommand
2 Parameters
2.1 Options
-d destination
Name of the file-based destination to archive.
The name of the file-based destination is used to retrieve the directory name from
the parameter file. The file-based destination must be a destination which is
defined in the parameter file. If the directory name is empty, fosarchive uses the
default %FOS_DATA%\<OutputStreamID>\<SenderID>. Either option -d or
option -p must be specified.
-p directory

16/11/2017 R1
Name of the directory to archive.

The directory must exist and the subdirectories Ready, Delete, and Archive will be
created if they do not exist. Either option -d or option -p must be specified.
-s maxfilesize
Maximum size in kilobytes of Formatted Call Record Block (FCRB) files to archive.
The value should be less than 4.194.304 kilobytes (4GB) (the limitation of the
fosarchive command).
It is the responsibility of the user to specify a value not greater than the
maximum capacity of the backup medium, or the Archive command. Mandatory.
-i Include
Indication to include the files in the Send directory for archiving as well. The
subdirectory Send will be created if it does not exist.
-m Move
Indication to move all archived files from the Archive directory to the Delete
directory after successful archiving.
2.1.1 Operands
archivecommand
This operand is the archive command string, including the name of the backup
medium.
It is assumed the archivecommand returns zero on success and non-zero on
failure. It has to be possible to specify the archive directory as the last option of
the archivecommand, because the fosarchive command appends the directory
name internally. Potentially any archiving program available on the operating
system may be used, but because of constraints (see below) imposed by
fosarchive it may be necessary to use an archivecommand wrapper instead. The
following archive command wrappers are delivered for APG40:
fostar
foscpio
These give limited tar and cpio functionality respectively.
foscopy - Flexible Formatter, Copy
1 Format
foscopy [ -d directoryname ]
2 Parameters

16/11/2017 R1
2.1 Options
-d directoryname
Directory name
This option specifies the directory name where the files are stored.
foscpio - Flexible Formatter, Cpio Archive
1 Format
foscpio [ -0AaBcLVv][ -C blocksize ][ -H format][ -M message][ -O file]
[ -F file] dir
2 Parameters
2.1 Options
-0 ...
Read a list of filenames terminated by a null character instead of a newline
This option can be used to archive files whose names contain newlines
-A ...
Append
Append to an existing archive. The archive must be a disk file specified with the
-O or -F option.
-a ...
Reset access times
Reset access times of input files after they have been copied.
-B ...
Block input/output 5120 bytes to the record
The default buffer size is 512 bytes when this and the -C options are not used. -B
is meaningful only with data directed to or from a character special device.
-c ...
Read or write header information in ASCII character form for portability
This option produces an archive more amenable to transfer through non-binary
streams and is highly recommended for moving data between different
processors.
-L ...
Dereference symbolic links
Dereference symbolic links (copy the files that they point to instead of copying the
links)
-V ...
Print a dot
Print a "." for each file processed

16/11/2017 R1
-v ...
Verbose
Print a list of file names.
-C blocksize ...
Input/output blocksize
Input/output blocksize bytes to the record, where buffersize is replaced by a
positive integer. The default buffersize is 512 bytes when this and -B options are
not used.
-H format ...
Use specified archive format
Use specified archive format. The valid formats are listed below; the same names
are also recognized in all-caps. The default format is bin. bin: The obsolete binary
format odc: The old (POSIX.1) portable format newc: The new (SVR4) portable
format, which supports file systems having more than 65536 i-nodes crc: The new
(SVR4) portable format with a checksum added tar: The old tar format ustar: The
POSIX.1 tar format
-M message ...
Print specified message
Print specified message when the end of a volume of the backup media is
reached, to prompt the user to insert a new volume. If the specified message
contains the string "%d", it is replaced by the current volume number (starting at
1).
-O outputdevice ...
Direct the output of cpio to output device
Direct the output of cpio to an output device. If output device is a character
special device and the current medium is full, replace the medium and type a
carriage return to continue to the next medium.
When you specify a tape device as output medium, please use /dev/mt , which
will amount to using //./TAPE0 as tape device. Do not specify //./TAPE0 as
tape device.
-F file ...
Archive filename
Archive filename to use instead standard output. This option is used in the same
way as the -O option (the difference is that this option can also be specified when
reading existing archives with cpio, whereas the -O option can only be used when
writing new archives).
2.1.1 Operands
dir ...
Directory to be archived.
The list of files contained in the directory is provided on the standard input of the
cpio command. In the directory path, backslashes (\) must be used.
fosview - Flexible Formatter, View System Information


16/11/2017 R1
1 Format
fosview [ -s][ -c][ -f][ -p][ -b]
2 Parameters
2.1 Options
-b Status of destination storage buffers.

This option indicates that the status of the file-based destination storage buffers
will be displayed.
-c Charging Parameters.
This option indicates that the charging parameters, i.e. filtering, formatting,
wrapping and statistics scripts, will be displayed.
-f Changeable Parameter Tables
This option indicates that the changeable parameter tables will be displayed.
-p Permanent Parameter Tables
This option indicates that permanent parameter tables will be displayed.
-s Statistic Counters
This option indicates that the statistics counters will be displayed.
foslview - Flexible Formatter, View Unprocessed Data Log
1 Format
foslview -f log-file -s asne-spec
2 Parameters
2.1 Options
-f log file ...

Unprocessed Data Log File
This option specifies the unprocessed data log file containing the encoded,
unprocessed data that is to be viewed. The complete path name of the file must
be specified, when the command is invoked outside the directory where the log
file is located.
-s asne-spec ...
ASN.E Specification

16/11/2017 R1
This option specifies the file containing the ASN.E specification that is to be used
for decoding the data in the unprocessed data log file. The complete path name of
the file must be specified, when the command is invoked outside the directory
where asne-spec is located.

Alex de Apg-40

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Alex de Apg-40

Cargado por

Copyright:

Formatos disponibles

NOT AN OFFICIAL TEST DOCUMENT

INTERNAL USE ONLY 1 (147)

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

Alphabetical list of APG40 commands click on command to see

acease - AP Alarms Ceasing

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

clhtran - Central Log Handler, Log, Transfer

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

fosview - Flexible Formatter, View System Information

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

stmdbrt - Statistics and Traffic Measurement, Database Retainment Time

Usefull links for commands description and APG40 guides

APG40 OVERWIEV AND USEFULL LINKS

COMMANDS LIST AND DESCRIPTION

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

afpchd - Adjunct Processor File Processing, File Definition,

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

afpdef - Adjunct Processor File Processing, File, Define

-b Countdown before status DELETE

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

Destination set name

afprm - Adjunct Processor File Processing, File, Delete

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

afpls - Adjunct Processor File Processing, Files, List

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

afpfte - Adjunct Processor File Processing, Manual Transfer,

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

afpfti - Adjunct Processor File Processing, Manual Transfer,

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

alddef - Alarm-Display Data, Define

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

aldrm - Alarm-Display Data, Delete

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

aldls - Alarm-Display Data, List

aldpls - Alarm-Display Properties, List

aldpdef - Alarm-Display Property, Define

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

aldprm - Alarm-Display Property, Delete

aldblk - Alarm-Display, Block

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

alddeblk - Alarm-Display, Deblock

aldquiet - Alarm-Display, Quiet

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

aldtest - Alarm-Display, Test

acease - AP Alarms Ceasing

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

alist - AP Alarms Listing

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

aehevls - AP, Application, System and SecurityLog, List

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

burbackup - AP, Backup, Initiate

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

This option allows the user to specify the source file.

burverify - AP, Backup, Verify

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

aehls - AP, EventLog, List

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description

nsfreset - AP, Network Surveillance, Reset

nsfstart - AP, Network Surveillance, Start

ETK/OSD ETKGPM mario.gasparic@ericsson.com APG40 commands description