pdls [-d rpl] (Display HiRDB Datareplicator linkage status)
Function
Displays the HiRDB Datareplicator linkage status. Also displays the extraction status of the extracted HiRDB Datareplicator system log in the system log file.
Format
pdls -d rpl [-j] [-u unit-identifier] [-s server-name]
Options
Specifies that the extraction status of the extracted HiRDB Datareplicator system log in the system log file is to be displayed. When this option is specified, the following information is displayed:
- Whether or not the HiRDB Datareplicator linkage facility is being used
- The extraction status of the system log from the system log file of the extracted HiRDB Datareplicator
- Internal information used by the system
When this option is omitted, the only information displayed is whether or not the HiRDB Datareplicator linkage facility is being used (the extraction status of the system log and the internal information are not displayed).
- -u unit-identifier
<identifier> ((4 characters))
Specifies the unit identifier of a unit in order to display the extraction status of the extracted HiRDB Datareplicator system log for that unit. When this option is omitted, this information is displayed for all units in the system. When the -j option is omitted and this option is specified, whether or not the system and the specified unit are using the HiRDB Datareplicator linkage facility is displayed.
- -s server-name
<identifier> ((1-8))
Specifies a server name in order to display the extraction status of the extracted HiRDB Datareplicator system log for that server. When this option is omitted, this information is displayed for all servers in the system. When the -j option is omitted and this option is specified, whether or not the system and the unit containing the specified server are using the HiRDB Datareplicator linkage facility is displayed.
Notes
- Return code 0 for the pdls -d rpl command indicates normal termination, and return code 8 indicates abnormal termination.
- When the -j option is specified and the -u and -s options are omitted in a pdls command in which -d rpl is specified, the HiRDB Datareplicator linkage facility status is displayed for all servers of all units in the system.
- A pdls command with -d rpl specified can be executed even if the server is inactive.
However, an error results if the extracted HiRDB Datareplicator directory name is not specified in pd_rpl_hdepath in the system definition or if there is no link file for data linkage.
Output format
-j option omitted
SYSTEMID :aaaa(bbccdd) 1
Data Replication :e 1
UNITID :ffff(bbccdd) 2
Data Replication :e 2
- If the -u option was specified for a HiRDB/Parallel Server, this information is displayed only when the specified unit is the server machine where the system manager is located.
- In the case of a HiRDB/Parallel Server, this information is displayed as many times as there are units in the system. If the -u option was specified, this information is displayed only for the specified unit.
- Explanation
- aaaa
- HiRDB identifier (4 characters)
- bbccdd
- Time (hour:minute:second) when the pdls command was entered
- e
- One character indicating whether or not the HiRDB Datareplicator linkage facility is being used at the HiRDB system and unit (Y is displayed, indicating that the HiRDB Datareplicator linkage facility is being used, even if there is no database to be linked to all back-end servers in the system and in the unit):
- Y
- HiRDB Datareplicator linkage facility is being used
- N
- HiRDB Datareplicator linkage facility is not being used
- *
- System linkage status cannot be displayed because the system manager is inactive (the status of each unit should be checked; if there is even one unit that is not using the HiRDB Datareplicator linkage facility, it will be shown that the HiRDB Datareplicator linkage facility is not being used by the system)
- -
- There is no server subject to HiRDB Datareplicator linkage in this unit (the server to be linked is a back-end server in the case of a HiRDB/Parallel Server and the single server in the case of a HiRDB/Single Server)
- ffff
- Unit identifier (4 characters)
-j option specified
SYSTEMID :aaaa(bbccdd) 1
Data Replication :e 1
UNITID :ffff(bbccdd) 2
Data Replication :e 2
SERVER NAME :gg...g 2,3
Extract Database :h 2,3
Extract Status :I 2,3
System Log Extract Point : 2,3,4
Run ID Group Gen No. Block No. 2,3,4
jj...j kk...k ll...l mm...m 2,3,4
System Log Sync info : 2,3,4
Run ID Group Gen No. Block No. 2,3,4
nn...n oo...o pp...p qq...q 2,3,4
- If the -u option is specified for a HiRDB/Parallel Server, this information is displayed only if the specified unit is the server machine where the system manager is located.
- In the case of a HiRDB/Parallel Server, this information is output for only the number of units in the system.
- In the case of a HiRDB/Parallel Server, this information is displayed as many times as there are servers in the unit. If the -s option was specified, this information is displayed only for the specified server. If the pd_rpl_hdepath operand is omitted in the system definition or the linkage file is invalid (for example, because the file is missing), this information is not displayed.
- This information is displayed only when the specified HiRDB server contains the target database that is to be extracted. If the -u option was specified, this information is displayed only for the specified unit.
- Explanation
- aaaa
- HiRDB identifier (4 characters)
- bbccdd
- Time (hour:minute:second) when the pdls command was entered.
- e
- One character indicating whether or not the HiRDB Datareplicator linkage facility is being used at the HiRDB system and unit (Y is displayed, indicating that the HiRDB Datareplicator linkage facility is being used, even if there is no database to be linked to all back-end servers in the system and in the unit):
- Y
- HiRDB Datareplicator linkage facility is being used
- N
- HiRDB Datareplicator linkage facility is not being used
- *
- System linkage status cannot be displayed because the system manager is inactive (the status of each unit should be checked; if there is even one unit that is not using the HiRDB Datareplicator linkage facility, it will be shown that the HiRDB Datareplicator linkage facility is not being used by the system)
- -
- There is no server subject to the HiRDB Datareplicator linkage in this unit (the server to be linked is a back-end server in the case of a HiRDB/Parallel Server and the single server in the case of a HiRDB/Single Server)
- ffff
- Unit identifier (4 characters)
- gg...g
- Server name (up to 8 characters)
- h
- Whether or not there is a database to be extracted:
- Y
- There is a database to be extracted at the indicated HiRDB server
- N
- There is no database to be extracted at the indicated HiRDB server
- i
- Internal information used by the system (one character)
- The information below is displayed when the HiRDB Datareplicator linkage facility is being used.
- Extraction information from extracted HiRDB Datareplicator system log
- jj...j
- Run ID (run ID of log service when file was used) (8 hexadecimal digits)
- kk...k
- Group name of system log file currently being extracted (up to 8 characters)
- ll...l
- Generation number of system log file currently being extracted (8 hexadecimal digits)
- mm...m
- System log block number currently being extracted (8 hexadecimal digits)
- Internal information from extracted HiRDB system log
- nn...n
- Internal information used by the system (8 characters)
- oo...o
- Internal information used by the system (up to 8 characters)
- pp...p
- Internal information used by the system (up to 8 characters)
- qq...q
- Internal information used by the system (up to 8 characters)
- Note
- Items j through q are displayed as blanks or zeros when HiRDB Datareplicator linkage does not start after the link file for data linkage is initialized or when the link file for data linkage was initialized during execution of HiRDB Datareplicator linkage.