Appendix C. Dataset Name Determination

When issuing a put command to create a dataset, or get to a local dataset using the cozsftp client, the resulting dataset name is determined as follows:

put myfile //HLQ.LEVEL
get myfile //HLQ.LEVEL (using the cozsftp client)

Table C.1. Dataset Name determination

Case	Condition	Dataset Name	Notes
1	HLQ.LEVEL is a Sequential Dataset	HLQ.LEVEL	Replaces existing SEQ dataset
2	HLQ.LEVEL is a PDS	HLQ.LEVEL(MYFILE)	Creates or replaces member named `MYFILE` in PDS
3	HLQ.LEVEL is not a dataset, but HLQ.LEVEL.XXX names exist in catalog	HLQ.LEVEL.MYFILE	Create or replace SEQ dataset
4	HLQ.LEVEL is not a dataset, and no HLQ.LEVEL.XXX names exist in catalog	HLQ.LEVEL	Creates new SEQ dataset

In most cases, this is acceptable behavior. However, there are cases where the supplied name should be treated as a dataset rather than a "directory" (as in Case 3 above). If this is the required behavior, a different dataset prefix can be supplied: //! or /-/!:

put myfile //!HLQ.LEVEL
get myfile //!HLQ.LEVEL  (using the cozsftp client)

Table C.2. Dataset Name determination

Case	Condition	Dataset Name	Notes
1	HLQ.LEVEL is a Sequential Dataset	HLQ.LEVEL	Replaces existing SEQ dataset
2	HLQ.LEVEL is a PDS	HLQ.LEVEL(MYFILE)	Creates or replaces member named `MYFILE` in PDS
3	HLQ.LEVEL is not a dataset	HLQ.LEVEL	Creates new SEQ dataset

NOTE: If you intend to always use a fully qualified dataset name, it is preferable to use the //! or /-/! syntax.

Prev		Next
Appendix B. Session config files	Contents	Appendix D. SMF Information

Prev		Next
Appendix B. Session config files	Home	Appendix D. SMF Information

Co:Z SFTP - User's Guide V 2.0.0

Appendix C. Dataset Name Determination