The following code changes the name of a file from samantha in a previously looked-up directory whose vnode token is in DIRVNODETOK to sam in a previously looked-up directory whose vnode token is in DIRVNODETOK2. For the callable service, see v_rename (BPX1VRN, BPX4VRN) — Rename a file or directory. For the data structure, see and BPXYOSS — Map operating system specific information.

         MVC   BUFFERA(08),=CL08'samantha' Old name
         MVC   BUFLENA,=F'08'
         MVC   BUFFERB(03),=CL03'sam'      New name
         MVC   BUFLENB,=F'03'
         MVC   OSSSTOR,OSS           Initialize BPXYOSS area
         SPACE ,
         CALL  BPX1VRN,              Rename a file                     +
               (DIRVNODETOK,         Input: Old directory vnode token  +
               OSSSTOR,              Input/output: BPXYOSS             +
               BUFLENA,              Input: Old name length            +
               BUFFERA,              Input: Old name                   +
               DIRVNODETOK2,         Input: New directory Vnode token  +
               BUFLENB,              Input: New name length            +
               BUFFERB,              Input: New name                   +
               RETVAL,               Return value: 0 or -1             +
               RETCODE,              Return code                       +
               RSNCODE),             Reason code                       +
               VL,MF=(E,PLIST)       ----------------------------------