Management Information Related Display command

You can display the relation summary of the registered management information in a list format.

The displayed content is output to the standard output. You can write the content to a file or output it to a printer by using the redirection (greater than, >) or pipe (vertical bar, |) symbol.

Format of command

utlidlist -i {snd|rcv|job|hst|tgrp|fmt|mfmt|trg} -id ID [-list] [-l|-v8] [-s|-e|-8|-g]

Explanation of the parameters

-i {snd|rcv|job|hst|tgrp|fmt|mfmt|trg}

Specify the type of the management information to display in a list format. (Mandatory)

snd:: Send Management Information
rcv:: Receive Management Information
job:: Job Information
hst:: Host Information
tgrp:: Transfer Group Information
fmt:: Format Information
mfmt:: Multi Format Information
trg:: File Trigger Information

Note

You can use the File Trigger Information database only if HULFT10 Enterprise grade is installed.

-id ID

ID of the information record or records to be displayed in a list format (Mandatory)

For IDs other than Host Information IDs, specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes. For a Host Information ID, specify an alphanumeric string within 68 bytes.

The IDs of Send Management Information and Receive Management Information database records are not case sensitive.

Use an asterisk (*) to specify multiple IDs.

By using an asterisk (*), you can designate all IDs or a prefix match. Use double quotation marks (") to delimit a string that includes an asterisk. (Example: "ABC*")

-list

An ID list is displayed. (Optional)

When specified, the relationship chart of each management information will be displayed.

-l|-v8

Specify the list format for output (Optional)

When you specify -l

The output appears in the format for HULFT lower than Ver.8.

Only the first 8 bytes of the ID are displayed.

If the data per line exceeds 80 bytes, the comment text is wrapped partway through.
When you specify -v8

Each ID appears in full even if it exceeds 8 bytes in length, and the comment text appears in a format that does not require wrapping partway.
When you omit both -l and -v8

The output appears in the format for HULFT lower than Ver.8.

Only the first 8 bytes of the ID are displayed.

If the data per line exceeds 80 bytes, only the portion of the comment text that fits within an 80-byte line appears.

-s|-e|-8|-g

Specify the Code Set for Transfer that is used in the management information. (Optional)

-s:: Shift-JIS
-e:: EUC-JP
-8:: UTF-8
-g:: GB18030

HULFT uses the specified Kanji code type in re-formatting during output processing.

When omitted, the value that is specified for Code Set for Transfer (cs4trnsfr) in the System Environment Settings is applied.

Note

'-s|-e|-8|-g' is not a parameter to convert data from one character encoding to another character encoding.

Remarks

You can display ID lists of multiple types of management information records by repeating '-i {snd|rcv|job|hst|tgrp|fmt|mfmt|trg} -id ID.'

Example

Displaying a list of IDs beginning with F which is registered in the Send Management Information
```
utlidlist -i snd -id "F*" -list
```
Displaying a relation summary for ID F000001 registered in the Receive Management Information
```
utlidlist -i rcv -id F000001
```
Displaying a relation summary for IDs beginning with m registered in the Multi Format Information and IDs starting with f registered in the Format Information
```
utlidlist -i fmt -id "f*" -i mfmt -id "m*"
```

Display example

List Display of Management Information

List display of the Send Management Information (when -list and -v8 are specified)

<Sending Management Information Summary>
[SendID] 
FILEID000000001 
         The comment in the Send Management Information 
FILEIDTOHONSHA0000001 
FILEIDFROMSHITEN 
         The comment in the Send Management Information. Up to 60 bytes can be displayed.

List display of the Receive Management Information (when -list and -v8 are specified)

<Receiving Management Information Summary>
[RcvID] 
FILEID000000001 
         The comment in the Receive Management Information 
FILEIDTOHONSHA0000001 
FILEIDFROMSHITEN 
         The comment in the Receive Management Information. Up to 60 bytes can be displayed.

List display of the Job Information (when -list and -v8 are specified)

<Job Startup Information Summary>
[JobID] 
SUCCESSJOBID1234567890 
         The comment in the Job Information 
UNSUCCESSJOBID987654321 
PREJOBIDFILEID001 
         The comment in the Job Information. Up to 60 bytes can be displayed.

List display of the Host Information (when -list and -v8 are specified)

<Host Information Summary>
[HostName] 
redhat6.honsya.co.jp 
         The comment in the Host Information 
AIX5.shiten.co.jp 
as30 
         The comment in the Host Information. Up to 60 bytes can be displayed.

List display of the Transfer Group Information (when -list and -v8 are specified)

<Transfer Group Information Summary>
[TgrpID] 
TGRP000000000000000000000000000000000000000000001 
         The comment in the Transfer Group Information 
TGRP000002 
TGRP000003  
         The comment in the Transfer Group Information. Up to 60 bytes can be displayed. 
TGRP00000000000000004 
         commentABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZ

List display of the Format Information (when -list and -v8 are specified)

<Format Information Summary>
[FMTID] 
F0000000000000000000000000000000000000000000000001 
         The comment in the Format Information 
F000002 
F000003  
         The comment in the Format Information. Up to 60 bytes can be displayed. 
F00000000000000004 
         commentABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZ

List display of the Multi Format Information (when -list and -v8 are specified)

<Multi Format Information Summary>
[MFMTID] 
M0000000000000000000000000000000000000000000000001 
         The comment in the Multi Format Information 
T000002 
T000003  
         The comment in the Multi Format Information. Up to 60 bytes can be displayed. 
T00000000000000004 
         commentABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZ

List display of the File Trigger Information (when -list and -v8 are specified)

<File Trigger Information Summary>
[TrgID] 
T0000000000000000000000000000000000000000000000001 
         The comment in the File Trigger Information 
T000002 
T000003  
         The comment in the File Trigger Information. Up to 60 bytes can be displayed. 
T00000000000000004 
         commentABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZ

Relation summary of Management Information

Relation summary of the Send Management Information (when -list is omitted and -v8 is specified)
```
<Sending Management Information Summary>
FILEID000000123456789 
           [TgrpID]    TGRPIDHONSYAABCDEFGHIJKLMN 
           [JobID]    *JOB1234567890ABCDEFGHIJKLMN 
           [ErrJobID]  ERRJOB12345 
           [PreJobID]  
           [FMTID]     
           [MFMTID]   *MFMTID00001
```
An ID starting with an asterisk (*) indicates that it is not registered in the management information.

SendID:

File ID of the Send Management Information record specified by the parameter

TgrpID:

Transfer group ID that is registered in the record with SendID

JobID:

Successful job ID that is registered in the record with SendID

ErrJobID:

Unsuccessful job ID that is registered in the record with SendID

PreJobID:

Pre-send Job ID that is registered in the record with SendID

FMTID:

Format ID that is registered in the record with SendID

MFMTID:

Multi format ID that is registered in the record with SendID
Relation summary of the Receive Management Information (when -list is omitted and -v8 is specified)
```
<Receiving Management Information Summary>
FILEID000000123456789 
           [TgrpID]    TGRPIDHONSYAABCDEFGHIJKLMN 
           [JobID]    *JOB1234567890ABCDEFGHIJKLMN 
           [ErrJobID]  ERRJOB12345
```
An ID starting with an asterisk (*) indicates that it is not registered in the management information.

RcvID:

File ID of the Receive Management Information record specified by the parameter

TgrpID:

Transfer group ID that is registered in the record with RcvID

JobID:

Successful job ID that is registered in the record with RcvID

ErrJobID:

Unsuccessful job ID that is registered in the record with RcvID
Relation summary of the Job Information (when -list is omitted and -v8 is specified)
```
<Job Startup Information Summary>
SUCCESSJOBID1234556789 
           [SendID]    FILEID1234567890ABCDEFGHIJKLMN 
                       FILEID987654321 
           [RcvID]     FILEID98 
           [TrgID]     TGRPIDHONSYA12345 
SUCCESSJOBID 
           [TrgID]     TGRPIDHONSYA12345
```
SendID:

File ID and comment in the Send Management Information record in which the job ID is registered

RcvID:

File ID and comment in the Receive Management Information record in which the job ID is registered

TrgID:

Trigger ID and comment in the File Trigger Information record in which the job ID is registered
Relation summary of the Host Information (when -list is omitted and -v8 is specified)
```
<Host Information Summary>
redhat6.honsya.co.jp 
           [TgrpID]    TGRPID1234567890ABCDEFGHIJKLMN 
                       TGRPID987654321 
AIX5.shiten.co.jp 
           [TgrpID]    TGRPIDHONSYA12345
```
IDs with an empty 'TgrpID' field are not registered in the Transfer Group Information.

TgrpID:

Transfer group ID and comment in the Transfer Group Information record in which the host name is registered
Relation summary of the Transfer Group Information (when -list is omitted and -v8 is specified)
```
<Transfer Group Information Summary>
T0000000000000000000000000000000000000000000000001 
           [SendID]   FILEID1234567890ABCDEFGHIJKLMN 
                      FILEID987654321 
           [RcvID]    FILEID1234567890ABCDEFGHIJKLMN 
           [HostName] host1.honsya.co.jp 
T000002 
           [HostName] as30
```
An ID starting with an asterisk (*) indicates that it is not registered in the management information.

IDs with an empty 'SendID' field are not registered in the Send Management Information.

IDs with an empty 'RcvID' field are not registered in the Receive Management Information.

SendID:

File ID and comment in the Send Management Information record in which the transfer group ID is registered

RcvID:

File ID and comment in the Receive Management Information record in which the transfer group ID is registered

HostName:

Host name that is registered in the transfer group with the transfer group ID
Relation summary of the Format Information (when -list is omitted and -v8 is specified)
```
<Format Information Summary>
T0000000000000000000000000000000000000000000000001 
           [MFMTID]   MFMTID1234567890ABCDEFGHIJKLMN 
T000002 
           [SendID]   FILEIDSAMPLE0000000000001 
T000003333333 
           [MFMTID]  ABCDEFGHIJKLMN
```
An ID starting with an asterisk (*) indicates that it is not registered in the management information.

SendID:

File ID and comment in the Send Management Information record in which the format ID is registered

MFMTID:

Multi format ID of the Multi Format Information record in which the format ID is registered
Relation summary of the Multi Format Information (when -list is omitted and -v8 is specified)
```
<Multi Format Information Summary>
T0000000000000000000000000000000000000000000000001 
           [FMTID]    default 
                      FMTID1234567890ABCDEFGHIJKLMN 
           [SendID]   FILEIDSAMPLE0000000000001 
T000002 
           [FMTID]   *default2 
                      FMTID12345678901234
```
An ID starting with an asterisk (*) indicates that it is not registered in the management information.

SendID:

File ID and comment in the Send Management Information record in which the multi format ID is registered

FMTID:

Format ID of the Format Information record that is registered in the multi format ID
Relation summary of the File Trigger Information (when -list is omitted and -v8 is specified)
```
<File Trigger Information Summary>
T0000000000000000000000000000000000000000000000001 
           [JobID]    JOBID1234567890ABCDEFGHIJKLMN 
T000002 
           [JobID]    JOBIDSAMPLE0000000000001 
T000003333333 
           [JobID]   *ABCDEFGHIJKLMN
```
An ID starting with an asterisk (*) indicates that it is not registered in the management information.

JobID:

Job ID that is registered in the record with the trigger ID