LD$HELP.HLB  —  LD  SHOW
   LD SHOW [LDAn:]

 	This command will display information about the status and
 	the connected Logical Disk file or device.

 	It can also be used to display the tracebuffer.

1    /ACCURATE

 	This qualifier was used in the past to allow accurate timing
 	measurements. A new method of collecting the timing has been
 	used which always collects the accurate samples, making this
 	qualifier obsolete. It will be ignored.

2    /ALL

 	This qualifier will show the status of all LDAn devices on
 	the system. It can not be specified in combination with /TRACE.

 	No devicename must be given in this case.

3    /BINARY

 	This qualifier forces the tracebuffer data to be written to
 	the outputfile in binary form. The is required when the outputfile
 	has to be processed later on with /INPUT.

4    /BLOCKS

   /BLOCKS=blocks

 	This qualifier specifies the maximum size of a diskfile with
 	tracedata. After this size is reached the current file is closed,
 	and a new one with a higher version is opened. If this qualifier
 	is not specified then there's no limit. If the /VERSION_LIMIT
 	qualifier is specified too, then the excess datafiles will be
 	purged.

5    /BYTECOUNT

   /BYTECOUNT [=HEX,DECIMAL] (Default)
   /NOBYTECOUNT

 	This qualifier enables the number of requested bytes to be
 	displayed. It allows either Hex or Decimal format, where
 	decimal is the default.

6    /CONTINUOUS

   /CONTINUOUS

 	When this qualifier is specified, the trace buffer of the
 	specified device will be dumped (if there's still data
 	waiting). After that the program will wait for new data to
 	show up, and display that if it's available.

 	To exit this mode one can type either a Control-Z or a
 	Control-C. Another way is to issue a LD TRACE/STOP command
 	from another process.

7    /ENTRIES

   /ENTRIES[=(XXX,YYY)]]

 	This qualifier allows selection of the tracebuffer contents.

 	If one parameter is specified, it will be the number of entries
 	from the start of the tracebuffer when positive, or from the end
 	of the tracebuffer when negative.

 	For example, /ENTRIES=10 will show the first 10 entries, while
 	/ENTRIES=-10 will show the last 10 entries.

 	When two parameters are specified, a range of entries will be shown.
 	For example, /ENTRIES=(30,50) will show all entries from entry
 	30 through entry 50 inclusive.

 	The default of -10 will show the last 10 entries.

8    /FDT

 	This qualifier allows FDT routine access to be displayed from the
 	tracebuffer, provided that it was enabled with the setup of the trace.

 	This function is only supported on Alpha.

9    /FULL

  /FULL
  /NOFULL (default)

 	This qualifier will show all attributes of the selected LD device,
 	like sharing, connection type etc.

10    /FUNCTION

   /FUNCTION[=Keyword]
   /NOFUNCTION

 	This qualifier enables the Function code of the request to be
 	displayed.

 	An optional keyword may be given:

 	FUNCTION=TEXT		Displays the translated I/O request function
 				along with eventual functioncode modifiers.
 				Function bits which could not be translated
 				will be shown in hexadecimal format.

 	FUNCTION=HEX		Displays the I/O request function code
 				in hexadecimal format.

 	The default is /FUNCTION=TEXT.

11    /HEADER

   /HEADER (Default)
   /NOHEADER

 	This qualifier enables a header to be displayed before showing
 	tracedata. The header contains a timestamp of when the trace
 	was made, a devicename of the LD-device involved and the nodename
 	of the system.

12    /NUMBER

   /NUMBER
   /NONUMBER (Default)

 	This qualifier enables entrynumbers to be displayed.

13    /INDEX

   /INDEX=n

 	This qualifier enables watchpoint display by index. The parameter
 	is the watchpoint number as seen by the driver.

14    /INPUT

   /INPUT[=filespec]

 	This qualifier forces input tracedata to be read from the specified
 	file. The default filename is LD_TRACE.DAT.

15    /IOSB

   /IOSB[=Keyword]
   /NOIOSB

 	This qualifier enables the I/O status block of the request
 	to be displayed.

 	An optional keyword may be given:

 	IOSB=TEXT		Displays the translated errortext from
 				the iosb.

 	IOSB=HEX		Displays the first longword of the iosb
 				in hexadecimal format.

 	IOSB=LONGHEX		Displays both longwords of the iosb in
 				hexadecimal format.

 	IOSB=COMBINATION	Displays the translated error text from
 				the iosb, as well as the returned count in
 				the upper first word of the iosb.

 	The default is /IOSB=TEXT.

16    /LBN

   /LBN [=HEX,DECIMAL] (Default)
   /NOLBN

 	This qualifier enables to Logical blocknumber of the request
 	to be displayed. It allows either Hex or Decimal format, where
 	decimal is the default.

17    /OUTPUT

   /OUTPUT[=filespec]

 	This qualifier forces output of the tracedata data to be written
 	to the specified file. The default output will be readable ASCII,
 	unless /BINARY was also specified. In that case a binary file will
 	be written which can be processed at a later time with /INPUT.

 	The default filename is LD_TRACE.LOG for normal ASCII output, and
 	LD_TRACE.DAT for binary output.

18    /PID

   /PID (Default)
   /NOPID

 	This qualifier enables to Process Identification of the requesting
 	process to be displayed.

19    /RESET

 	When this qualifier is specified in combination with /TRACE,
 	the tracebuffer will be dumped and the buffer will be reset
 	afterwards. This is an atomic operation, such that no bufferdata
 	will be lost.

20    /STATUS

 	This qualifier will show the currently allocated size of the
 	tracebuffer, as well as the number of entries in use. It must
 	be used in combination with /TRACE.

21    /SYMBOL

 	This qualifier will set the LD unit number in DCL symbol LD_UNIT,
 	and the container file specification in the symbol LD_CONTAINER.

 	When used with tapes (LM) the symbols will be LM_UNIT and
 	LM_CONTAINER.

22    /TIMESTAMP

   /TIMESTAMP[=Keyword]
   /NOTIMESTAMP

 	This qualifier enables the Start-time as well as the End-time
 	or the Elapsed time of an I/O request to be displayed.

 	An optional keyword may be given:

 	TIMESTAMP=ABSOLUTE	Displays the Start-time of the request
 				as well as the End-time in absolute format.

 	TIMESTAMP=ELAPSED	Displays the Elapsed time of the request.

 	TIMESTAMP=COMBINATION	Displays the End-time of the request
 				in absolute format as well as the Elapsed
 				time of the request.

 	TIMESTAMP=DELTA		Displays the elapsed time between the current
 				request and the previous request. If the
 				end-time of the previous request was after
 				the end-time of the current request (out of
 				order I/O completion) the line will be preceded
 				with a dash.

 	TIMESTAMP=START		Displays Start-time of the request in absolute
 				format.

 	TIMESTAMP=END		Displays End-time of the request in absolute
 				format.

 	The default is /TIMESTAMP=COMBINATION.

23    /TRACE

 	When this qualifier is specified, the trace buffer of the
 	specified device will be dumped.

24    /VERSION_LIMIT

   /VERSION_LIMIT=limit

 	This qualifier can be used when a continuous trace is made
 	to control the number of concurrent datafiles on disk.
 	Anytime the datafilesize exceeds the size specified with
 	/BLOCKS a new file will be created after the old file is
 	closed. If there are more files available than the number
 	specified with this qualifier, they will be purged up till
 	the specified limit.

25    /WARNINGS

   /WARNINGS (Default)
   /NOWARNINGS

 	When this qualifier is specified a warning will be given
 	anytime when there are tracerecords lost. The number of lost
 	records will be displayed. /NOWARNINGS will suppress these
 	messages.

26    /WATCH

 	When this qualifier is specified, the currently set watchpoints
 	of the specified device will be dumped.
Close Help