Management Information Relations Output command

The relationship chart of the registered records of management information can be displayed as a list by using a command.

Note

Ensure that the CCSID (Coded Character Set Identifier) settings of your emulator (Host Code-Page) and the job that executes this command satisfy one of the following conditions: If your configuration does not meet one of the following, HULFT does not display a list properly.

[Configuration 1]

Complete agreement of CCSID (Coded Character Set Identifier) settings between your emulator and HULFT Character Set in the System Environment Settings file
Setting the CCSID (Coded Character Set Identifier) of the job to 65535

[Configuration 2]

Complete agreement of CCSID (Coded Character Set Identifier) settings between your emulator and HULFT Character Set in the System Environment Settings file
Complete agreement of CCSID (Coded Character Set Identifier) settings between the job and HULFT Character Set in the System Environment Settings file

Program interface

CALL Library name/UTLIDLIST PARM(['LIB=Library name'] 
   'I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}' 'ID=id' ['LIST'] ['L'|'V8'] 
   ['G'] ['OUTPUT=filename'] ['EXIT' CL variable name])

Explanation of parameters

LIB=Library name

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}

Select a type of the management information to be displayed in a list.

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

ID=id

Target ID or Host Name to be displayed in a list (Mandatory)

For an ID other than a Host Information ID, specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes. Specify Host Name in the Host Information as an alphanumeric character string of 68 bytes or less.

Using an asterisk (*) allows you to retrieve prefix matches of the ID.

LIST

Display ID list. (Optional)

When Omitted, the relationship chart by record of management information is displayed.

L

Display the host name and comment in full. (Optional)

When omitted, the values are truncated to fit the size of output field.

V8

Display the host name and ID in full. (Optional)

G

Control of error messages that the Management Information Relations Output command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Management Information Relations Output command outputs (Optional)

Specify this parameter in the format of Library name/File name(Member name).

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL variable name

Specifies to receive the error code output by the Management Information Relations Output command and specifies the CL variable name to set the error code value (Optional)

The CL variable name must be immediately after the EXIT tag.

HULFT sets an error code to the CL variable only if the command ends unsuccessfully.

When omitted, an error code is not set.

= Remarks =

To list various types of management information, repeat "I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}" and "ID=id".

Command interface

UTLIDLIST FILETYPE((i id)) LST( ) LONG( ) FORMAT() LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

FILETYPE

Management information and target ID to be displayed in a list (Mandatory)

i

Select a type of the management information to be displayed in a list.

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

id

Target ID or Host Name to be displayed in a list

Using an asterisk (*) allows you to retrieve prefix matches of the ID.

Specifying *ALL displays all IDs in the form of a list.

LST

Display ID list. (N by default)

N :: Display a relationship chart by record of management information.
Y :: Display ID list.

LONG

Display the host name and comment in full. (N by default)

N :: Truncate the values to fit the size of output field.
Y :: Display the host name and comment in full.

FORMAT

Format to display a relationship chart (*V7 by default)

*V7 :: Output the results in V7 format.
*V8 :: Output the results in V8 format.

LIBRARY

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

MSG

Control of error messages ("*YES" by default)

*NO :: Suppress error messages.
*YES :: Show error messages.

FILE

Name of the library and file to which error messages are output (Optional)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

Description example

Lists IDs starting with 'F' that is registered in the Send Management Information
```
CALL HULFT/UTLIDLIST PARM('I=SND' 'ID=F*' 'LIST')
```
Display relationship chart of ID 'F000001' registered in the Receive Management Information
```
CALL HULFT/UTLIDLIST PARM('I=RCV' 'ID=F000001')
```
Display relationship chart of ID starting with 'M' registered in the Multi Format Information and that of ID starting with 'F' registered in the Format Information
```
CALL HULFT/UTLIDLIST PARM('I=FMT' 'ID=F*' 'I=MFMT' 'ID=M*')
```

Output example

Display of management information list

<<SENDING MANAGEMENT INFORMATION SUMMARY>>                                 
<SENDID>   <TGRPID>   <JOBID>    <ERRJOBID> <PREJOBID> <FMTID>    <MFMTID> 
FILE0001   AS400      JOB02                                                

<<RECEIVING MANAGEMENT INFORMATION SUMMARY>>
<RCVID>    <TGRPID>   <JOBID>    <ERRJOBID>
FILE0001 
FILE0002  *TGRP0001 
FILE0003 

<<JOB STARTUP INFORMATION SUMMARY>>              
JOB01                                            
JOB02      <SENDID>   FILE0001                   
JOB03                                            

<<HOST INFORMATION SUMMARY>>                          
AS400                                                 
           <TGRPID>   TGRP0001                        
WINDOWSPC                                             
           <TGRPID>   TGRP0001    TOKYO HOST GROUP    

<<TRANSFER GROUP INFORMATION SUMMARY>>                                    
AS400      <SENDID>   FILE0001                                            
           <HOSTNAME> AS400                                               
TGRP0001   <HOSTNAME> AS400                                               
TGRP0001   <HOSTNAME> WINDOWSPC                                           

<<FORMAT INFORMATION SUMMARY>>
FMT0001    <MFMTID>   MFMT0001    SAPPORO URIAGE DATA 
FMT0001A   <MFMTID>   MFMT0001    SAPPORO URIAGE DATA 
FMT0002    <MFMTID>   MFMT0001    SAPPORO URIAGE DATA 

<<MULTI FORMAT INFORMATION SUMMARY>>                          
MFMT0001   <FMTID>    FMT0001A    FORMAT MAILADDRESS DATA     
                      FMT0001     FORMAT PERSONAL DATA        
                      FMT0002     PERSONAL URIAGE DATA        
MFMT0002   <FMTID>   *FMTFLATD                                
                     *FMT01TEN                                
                     *FMT02SHO

Relations output of the Send Management Information

 <<SENDING MANAGEMENT INFORMATION SUMMARY>>                                 
 <SENDID>   <TGRPID>   <JOBID>    <ERRJOBID> <PREJOBID> <FMTID>    <MFMTID> 
 FILE0001   AS400      JOB02

When you specify V8:

 <<SENDING MANAGEMENT INFORMATION SUMMARY>>                         
 FILE00018NAGOYA8TO8TOKYO                                           
            <TGRPID>    AS400                                       
            <JOBID>     JOB02                                       
            <ERRJOBID>                                              
            <PREJOBID>                                              
            <FMTID>                                                 
            <MFMTID>

The ID starting with '*' indicates that it is not registered in management information.

SENDID :: File ID for the record of the Send Management Information specified by the parameter
TGRPID :: Transfer group ID that is registered with the above file ID
JOBID :: Successful job ID that is registered with the above file ID
ERRJOBID :: Unsuccessful job ID that is registered with the above file ID
PREJOBID :: Pre-send job ID that is registered with the above file ID
FMTID :: Format ID that is registered with the above file ID
MFMTID :: Multi format ID that is registered with the above file ID

Relations output of the Receive Management Information

<<RECEIVING MANAGEMENT INFORMATION SUMMARY>>         
<RCVID>    <TGRPID>   <JOBID>    <ERRJOBID>          
FILE0001                                             
FILE0002  *TGRP0001                                  
FILE0003

When you specify V8:

<<RECEIVING MANAGEMENT INFORMATION SUMMARY>>          
FILE00018NAGOYA8TO8TOKYO                              
           <TGRPID>                                   
           <JOBID>                                    
           <ERRJOBID>                                 
FILE0002                                              
           <TGRPID>   *TGRP0001                       
           <JOBID>                                    
           <ERRJOBID>                                 
FILE0003                                              
           <TGRPID>                                   
           <JOBID>                                    
           <ERRJOBID>

The ID starting with '*' indicates that it is not registered in management information.

RCVID :: File ID in the record of the Receive Management Information specified by the parameter
TGRPID :: Transfer group ID that is registered with the above file ID
JOBID :: Successful job ID that is registered with the above file ID
ERRJOBID :: Unsuccessful job ID that is registered with the above file ID

Relations output of the Job Information

<<JOB STARTUP INFORMATION SUMMARY>>              
JOB01                                            
JOB02      <SENDID>   FILE0001                   
JOB03

When you specify V8:

<<JOB STARTUP INFORMATION SUMMARY>>                   
JOB01                                                 
JOB02                                                 
           <SENDID>    FILE00018NAGOYA8TO8TOKYO       
JOB03

SENDID :: File ID and comment in the record of the Send Management Information in which the above job ID is registered.
RCVID :: File ID and comment in the record of the Receive Management Information in which the above job ID is registered.

Relations output of the Host Information

<<HOST INFORMATION SUMMARY>>                          
AS400                                                 
           <TGRPID>   TGRP0001                        
WINDOWSPC                                             
           <TGRPID>   TGRP0001    TOKYO HOST GROUP

When you specify V8:

<<HOST INFORMATION SUMMARY>>                             
AS400                                                    
           <TGRPID>    TGRP0001NAGOYA                    
WINDOWSPC                                                
           <TGRPID>    TGRP0001TOKYO

Items without '<TGRPID>' are not registered in the Transfer Group Information.

TGRPID :: Transfer group ID and comment in the record of the Transfer Group Information in which the above host name is registered.

Relations output of the Transfer Group Registration

<<TRANSFER GROUP INFORMATION SUMMARY>>                                    
AS400      <SENDID>   FILE0001                                            
           <HOSTNAME> AS400                                               
TGRP0001   <HOSTNAME> AS400                                               
TGRP0001   <HOSTNAME> WINDOWSPC

When you specify V8:

<<TRANSFER GROUP INFORMATION SUMMARY>>                                     
AS400                                                                      
           <SENDID>    FILE00018NAGOYA8TO8TOKYO                            
           <HOSTNAME>  AS400                                               
TGRP0001NAGOYA                                                             
           <HOSTNAME>  AS400                                               
TGRP0001TOKYO                                                              
           <HOSTNAME>  WINDOWSPC

Items without '<SENDID>' or '<RCVID>' is not registered in the Send Management Information or Receive Management Information, respectively.

SENDID :: File ID and comment in the record of the Send Management Information in which above transfer group ID is registered.
RCVID :: File ID and comment in the record of the Receive Management Information in which above transfer group ID is registered.
HOSTNAME :: Host name registered with the above transfer group ID.

Relations output of the Format Information

<<FORMAT INFORMATION SUMMARY>>                            
FMT0001    <MFMTID>   MFMT0001    SAPPORO URIAGE DATA     
FMT0001A   <MFMTID>   MFMT0001    SAPPORO URIAGE DATA     
FMT0002    <MFMTID>   MFMT0001    SAPPORO URIAGE DATA

When you specify V8:

<<FORMAT INFORMATION SUMMARY>>                             
FMT0001                                                    
           <MFMTID>    MFMT0001URIAGEDATA                  
FMT0001ADDRESS                                             
           <MFMTID>    MFMT0001URIAGEDATA                  
FMT0002                                                    
           <MFMTID>    MFMT0001URIAGEDATA

SENDID :: File ID and comment in the record of the Send Management Information in which the above format ID is registered.
MFMTID :: Multi format ID in the record of the Multi Format Information in which the above format ID is registered.

Relations output of the Multi Format Information

<<MULTI FORMAT INFORMATION SUMMARY>>                          
MFMT0001   <FMTID>    FMT0001A    FORMAT MAILADDRESS DATA     
                      FMT0001     FORMAT PERSONAL DATA        
                      FMT0002     PERSONAL URIAGE DATA        
MFMT0002   <FMTID>   *FMTFLATD                                
                     *FMT01TEN                                
                     *FMT02SHO

When you specify V8:

<<MULTI FORMAT INFORMATION SUMMARY>>                            
MFMT0001URIAGEDATA                                              
           <FMTID>     FMT0001ADDRESS                           
                       FMT0001                                  
                       FMT0002                                  
MFMT0002NAGOYA                                                  
           <FMTID>    *FMTFLATDATA                              
                      *FMT01TENPO                               
                      *FMT02SHOP

The ID starting with '*' indicates that it is not registered in management information.

SENDID :: File ID and Comment in the record of the Send Management Information in which the above mentioned Multi Format ID is registered.
FMTID :: Format ID in the record of the Format Information in which the above mentioned Multi Format ID is registered.