1 :Info: phcs_:  1983-03-31  phcs_
 2 
 3 
 4 Entry points in phcs_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: read_disk_label:  1983-02-08 phcs_$read_disk_label
 9 
10 
11 Function: This entry point is used to read the label of a storage
12 system disk drive.  The label is described by the structure "label,"
13 in the include file fs_vol_label.incl.pl1.
14 
15 
16 Syntax:
17 dcl phcs_$read_disk_label entry (bit (36) aligned, pointer,
18      fixed bin (35));
19 call phcs_$read_disk_label (pvid, label_ptr, code);
20 
21 
22 Arguments:
23 pvid
24    is the physical volume id of the disk whose label is to be read.
25    (Input).  The physical volume id is used instead of the volume name
26    because this is a ring zero interface, and volume names are not
27    accessible by ring zero; hence, all ring zero interfaces that
28    reference physical volumes use the pvid.  A pvname can be converted
29    to a pvid by calling the subroutine mdc_$find_volname or can be
30    returned by a previous call to find_partition_.
31 label_ptr
32    is a pointer to the user-supplied buffer in which to read the label.
33    (Input).  The label is 1024 words long and is described in
34    fs_vol_label.incl.pl1.
35 code
36    is a nonstandard status code.  (Output).  See "List of codes" below.
37 
38 
39 List of codes:
40 0
41    indicates that the label was successfully read.
42 error_table_$pvid_not_found
43    indicates that the specified physical volume is not presently
44    mounted.
45 an integer between 1 and 10
46    indicates that a physical disk error occurred while trying to
47    read the label.  Error messages for physical disk errors are
48    declared in the include file fsdisk_errors.incl.pl1, in the array
49    fsdisk_error_message.
50 
51 
52 :hcom:
53 
54 
55 
56 /****^  HISTORY COMMENTS:
57   1) change(2020-05-18,GDixon), approve(2021-02-22,MCR10088),
58      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
59      Correct formatting errors in this info segment.  Content unchanged.
60                                                    END HISTORY COMMENTS */
61 
62 
63