MVSTMP(1)

MVSTMP(1)                 ZOAU Command Syntax               MVSTMP(1)

NAME

	mvstmp -- generate a valid MVS dataset name suitable for use as a 
	temporary dataset

SYNOPSIS

	mvstmp [-hvd] [prefix]
	 -h syntax
         -v print verbose messages
         -d print debug messages

ENVIRONMENT VARIABLES
	TMPHLQ:	overrides the prefix default value (MVSTMP)

DESCRIPTION

	Generate a name suitable for use as an MVS dataset name and write
	the name to stdout. No dataset is actually created - this utility
	just generates a name.

	The name is of the format:
		<prefix>.<process>.<timestamp>.<counter>

	The value of the components of the name are as follows:

	<prefix>
		defaults to MVSTMP if no prefix is specified.
		overrides TMPHLQ environment variable if provided
	<process> 
		P followed by the low order 7 digits of the process id
		of the mvstmp program instance
	<timestamp>
		T followed by the low order 7 digits of the microseconds
		component of the current time of day
	<counter>
		C followed by 7 0's 

EXAMPLES

	Generate a temporary dataset name with a high-level qualifier of TEST
		mvstmp TEST

EXIT VALUES

	0               mvstmp completed without error.
	
	non-zero        mvstmp failed. See error messages for details.