Contents - Index


 

Use ConsoleList to display the console of the current remote system.

 

ConsoleList may also be entered as ConsoleLi[st], ConsLi[st], ListCons[ole], LiCons[ole], DisplayC[onsole], DispC[onsole], or DC[onsole].

 

ConsoleList is currently supported only for VSE systems.

 

Optional Operands

 

FCT Specifies the number of lines to be generated in the display session.

 

 Default: 500.

 

PART Specifies the partition for which messages are to be displayed.  PART can be entered as either a 1 or 2 character value.  If 1 character is entered, all partitions with the same starting character will be displayed.

 

DATE Specifies the date for the newest console message to be included in the display.  DATE can be entered in one of the following formats: "mm/dd", "dd/mm", "mm/dd/yy", "mm/dd/yyyy", "dd/mm/yy" or "dd/mm/yyyy" depending upon the date format set by the System Administrator.  If "mm/dd" or "dd/mm" is entered, the current year is assumed.

 

 Default: The most recent messages are displayed.

 

TIME Specifies the time for the newest console message to be included in the display. TIME can be entered as hh:mm:ss or hh:mm, and is a 24-hour time.

 

 If both DATE and TIME are specified, the display ends with the first message generated on or before the specified DATA and TIME.

 

 Default: The most recent messages are displayed.

 

STR Specifies a string to search for.  Up to 72 characters can be specified. If the value of STR begins with the backslash character (\), the search will use Extended Search Pattern rules.

 

 If STR is specified in conjunction with DATE and/or TIME, the display will end with the first console message containing the specified STR that occurs on or before the specified DATE and/or TIME.

 

ZONE Specifies the column range for the search.  Enter it in the format "xxx-yyy" where xxx and yyy are numbers between 1 and 253.  For example, to limit the search to columns 10-20, specify ZONE as "10-20".  ZONE=5 is the same as ZONE=5-5, ZONE=5* is the same as ZONE=5-253, and ZONE=-5 is the same as ZONE=1-5.

 

 Default: 1-80.

 

Messages will be displayed in the session with the oldest message on top, and the newest message on the bottom.

 

Each line of the session contains the following information:

 

80 character console message.

 

Time message was generated.

 

Date message was generated.

 

Partition ID.

 

Unique message number assigned by VSE/ESA 2+.

 

The last line of the display will be one of the following messages:

 

   1I87I REPLY TO: pp-nnn, ...

   1I881 NO REPLIES OUTSTANDING

 

Return Codes

 

OK Successful.

 

Procedure Notes

 

ConsoleList sets the TXL variables to the attributes of DIR.

 

Examples

 

Create a display session for console messages generated on or before 05/01/2001 at 11:30 AM:

 

   => dc date=05/01/2001,time=11:30

 

Create a display session containing 1000 lines for console messages generated by partition BG that were generated on or before 01/01/2002:

 

   => dc fct=1000,date=01/01/2002,part=bg