File Specifications for IBM SPSS Collaboration and Deployment Services Repository Objects

Access to a IBM® SPSS® Collaboration and Deployment Services Repository is available with the Statistics Adapter option. Once a connection to a IBM SPSS Collaboration and Deployment Services Repository has been established, you can use a file specification for a IBM SPSS Collaboration and Deployment Services Repository object on nearly any keyword or subcommand where a file specification can be provided (including, but not limited to FILE, INFILE, or OUTFILE ). File specifications for IBM SPSS Collaboration and Deployment Services Repository objects can also be used in procedure dialog boxes that allow manual entry of a file specification—for example, XML model files or plan files for complex samples analyses.

A IBM SPSS Collaboration and Deployment Services Repository file specification has the following form:

SPSSCR://{directory path and/or file specification}

         [{#M.versionmarker}]
          {#L.versionlabel }

Note: Specification of descriptions (#D) and keywords (#K) is obsolete for release 17.0 and higher.

Basic Specification

The basic specification is the scheme name SPSSCR , followed by a colon, one or two slashes (forward or backward), and a directory path or file: for example:

GET FILE='SPSSCR://data/mydata.sav'.
  • A IBM SPSS Collaboration and Deployment Services Repository file specification is included on a GET command. The latest version of the file /data/mydata.sav that is accessible by the current user will be retrieved from the currently connected IBM SPSS Collaboration and Deployment Services Repository.

Syntax Rules

  • Paths can be specified with forward slashes (/) or backslashes (\).
  • The optional components of a file specification--version marker (#M) and version label (#L)--can be specified in any order.
  • When including an optional component, the character sequence that specifies the component--for example, #L--must be followed by a period (.).

File Extensions

Files are stored to the IBM SPSS Collaboration and Deployment Services Repository with an associated MIME type that specifies the type of file; for example, IBM SPSS Statistics format data, or viewer output. Including a file extension, such as .sav or .spv, is not necessary in order for the correct MIME type to be determined; however, it is recommended.

  • File extensions are not added to filenames when storing to a IBM SPSS Collaboration and Deployment Services Repository. For example, the following SAVE command results in the creation of a IBM SPSS Collaboration and Deployment Services Repository object with a MIME type of IBM SPSS Statistics-format data, and a fully qualified path of /data/mydata, but no sav extension.

    SAVE OUTFILE='SPSSCR://data/mydata'.

  • When retrieving IBM SPSS Collaboration and Deployment Services Repository objects, you must specify the filename exactly as provided when the file was stored. If the file was stored with an extension, then you must supply the extension. If the file was stored without an extension then do not include one.

Permissions

  • The PERMISSIONS, SAVE, and XSAVE commands will generate errors if you attempt to set permissions for IBM SPSS Collaboration and Deployment Services Repository objects. Permissions for IBM SPSS Collaboration and Deployment Services Repository objects are set with the REPOSITORY ATTRIBUTES command or using administration tools included with IBM SPSS Collaboration and Deployment Services.
  • The ERASE FILE command will generate an error if you attempt to delete a IBM SPSS Collaboration and Deployment Services Repository object.

Note: For users upgrading from an IBM SPSS Collaboration and Deployment Services 3.5 system, be aware that command syntax that retrieved the version labelled LATEST (the default version retrieved by GET FILE='filespec') in a 3.5 system will retrieve an earlier version in an IBM SPSS Collaboration and Deployment Services 4.x system if the current user does not have permission to view objects with the LATEST label.